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HOW TO USE THIS MANUAL 


The CTIX Operating System Manual, Version B, describes the 
commands, system calls, libraries, data files, and device 
interfaces that make up the CTIX Operating System on 
MiniFrame Computer Systems and MightyFrame Computer 
Systems. Only internal-use and unbundled software products are 
excluded. This manual should always be your starting point 
when you need to find the documentation for a CTIX feature 
with which you are unfamiliar. 


The manual consists of a large number of short entries, 
sometimes called “the man pages,’’ after the command which 
accesses the entries when they are kept online. Each entry 
briefly documents some feature of CTIX. Some features require 
longer documentation than an entry in this manual; such features 
have an entry that outlines the feature and cross-references the 
manual that documents the feature fully. Entries that do not 
refer to other manuals are self-contained and are the final word 
on the features they describe. 


Organization of the manual. The entries are organized into 
seven sections in two volumes: 


Volume 1: 
1. Commands and Application Programs. 


Volume 2: 

System Calls. 

Subroutines and Libraries. 
File Formats. 
Miscellaneous Facilities. 
Games. 

Special files. 
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Within each section, entries are alphabetical by title, except for 
an intro entry at the beginning of each section. 


Entry Title Conventions. An entry title looks like this 
example: 


erf(3M) 


Dt Type 
ection Number 


ame 
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Name is the name of the entry. Sectton Number indicates the 
section that contains the entry. In this case, the entry is in 
Section 3, which is in Volume 2. Entry Type is only on entries 
that belong to special categories; refer to the section’s intro entry 
for an explanation. In this case, a reference to intro(3) would tell 
you that erf3M) describes functions from the Math Library, 
which the C compiler does not load by default. 


Finding the entry you need. To find out which entry you 
need, refer to the following guides: 


° The Permuted Index. This indexes each significant word 
in each entry’s description. It is useful when you only 
have a general notion what you’re looking for. It is also 
useful when you know the name of the command, 
function, etc., that you are interested in, but there is no 
entry by that name. To simplify its use, a complete 
Permuted Index for both volumes is in each volume. 


e The Table of Contents. This is a simple list of entries, 
by section, together with the entry descriptions. Volume 
1 has a Table of Contents for Section 1. Volume 2 has a 
Table of Contents for Sections 2 through 7. 


° The Table of Related Entries. For Volume 1 only. A 
table of entries organized so that related entries are 
grouped together. 


Section organization. Each section begins with an intro entry, 
which provides important general information for that section. 


Section 1, Commands and Application Programs, describes 
programs intended to be invoked directly by the user or by 
command language procedures, as opposed to subroutines, which 
are intended to be called by the user’s programs. Commands 
generally reside in the directory /bin (for binary programs). 
Some programs also reside in /usr/bin, to save space in /bin. 
These directories are searched automatically by the command 
interpreter called the shell, Commands that were not 
transported from UNIX System V reside in /usr/local/bin; this 
directory is recommended for locally implemented programs. 
Some administrative commands reside in /ete and various other 
places. The /ete directory is searched automatically if you are 
logged in as root; otherwise type out the full path name given 
under SYNOPSIS or change the PATH environment variable to 
include the command’s directory. 


Section 2, System Calls, describes the entries into the CTIX 
kernel, including the C language interfaces. 
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Section 3, Subroutines and Libraries, describes the available 
library functions or subroutines. Their binary versions reside in 
various system libraries in the directories /lib and /usr/lib. See 
intro(3) for descriptions of these libraries and the files in which 
they are stored. 


Section 4, File Formats, documents the structure of particular 
kinds of files; for example, the format of the output of the link 
editor is given in a.out(4). Excluded are files used by only one 
command (for example, the assembler’s intermediate files). In 
general, the C language struct declarations corresponding to 
these formats can be found in the directories /usr/include and 
/usr /include/sys. 


Section 5, Miscellaneous Facilities, contains a variety of things. 
Included are descriptions of character sets, macro packages, etc. 


Section 6, Games, describes the games and educational programs 
that reside in the directory /usr/games. 


Section 7, Special Files, discusses the characteristics of files that 
actually refer to input/output devices. 


Entry organization. All entries are based on a common 
format, not all of whose parts always appear: 


The NAME part gives the name(s) of the entry and briefly 
states its purpose. 


The SYNOPSIS part summarizes the use of the program 
being described. A few conventions are used, particularly in 
Section 1 (Commands): 


Boldface strings are literals and are to be typed just as 
they appear. 


Italic strings usually represent substitutable argument 
prototypes and program names found elsewhere in the 
manual (they are underlined in the typed version of the 
entries). 


Square brackets [] around an argument prototype 
indicate that the argument is optional. When an 
argument prototype is given as “name” or “‘file’’, it 
always refers to a file name. 


Ellipses ... are used to show that the previous 
argument prototype may be repeated. 


A final convention is used by the commands themselves. 
An argument beginning with a minus -, plus +, or 
equal sign = is often taken to be some sort of flag 


argument, even if it appears in a position where a file 
name could appear. Therefore, it is unwise to have files 
whose names begin with —, +, or =. 


The DESCRIPTION part discusses the subject at hand. 


The EXAMPLE(S) part gives example(s) of usage, where 
appropriate. 


The FILES part gives the file names that are built into the 
program. 


The SEE ALSO part gives pointers to related information. 


The DIAGNOSTICS part discusses the diagnostic 
indications that may be produced. Messages that are 
intended to be self-explanatory are not listed. 


The WARNINGS part points out potential pitfalls. 


The BUGS part gives known bugs and _ sometimes 
deficiencies. Occasionally, the suggested fix is also 
described. 


A table of contents and a permuted index derived from that 
table precede Section 1. On each index line, the title of the 
entry to which that line refers is followed by the appropriate 
section number in parentheses. This is important because there 
is considerable duplication of names among the sections, arising 
principally from commands that exist only to exercise a 
particular system call. 


If the entries are online, they are available via the catman(1) 
command. 


PERMUTED INDEX 


This index includes entries for all pages of both Volumes 1} and 2. 
The entries themselves are based on the one-line descriptions or 
titles found in the NAME portion of each manual page; the 
significant words (keywords) of these descriptions are listed 
alphabetically down the center of the index. 


The index is actually a keyword-in-context (KWIC) index that 
has three columns. To use the index, read the center column to 
look up specific commands by name or by subject topics. Note 
that the entry may begin in the left column or wrap around and 
continue into the left column. A period (.) marks the end of the 
entry, and a slash (/) indicates where the entry has been 
continued or truncated. The right column gives the manual page 


where the command or subject is described. 


/functions of HP 2640 and 262l1-series terminals. . . ~ hp(1) 
/special functions of HP 2640 and 2621-series/ .. ~ hp(1) 
special functions of/ 300, 300s: handle... . . 300(1) 
/functions of DASI 300 and 300s terminals. . . 300(1) 
functions of DASI/ 300, 300s: handle special . . . ~ 300(1) 
/of DASI 300 and 300s terminals. . .. .. + 300(1) 
/ltol3: convert between 3-byte integers and long/ . . I3tol(3C) 
comparison. diff3: 3-way differential file . . . diff3(1) 
TEKTRONIX 4014/ 4014: paginator forthe . . . 4014(1) 
/for the TEKTRONIX 4014 terminal. .... . . 4014(1) 
functions of the DASI/ 450: handle special .. . ~ 450(1) 
functions of the DASI 450 terminal. /special - « 450(1) 


/parameters for Xylogics 
between long integer/ 


772 half-inch tape/ 
a64l, 164a: convert 


- xmset(1M) 


a641(3C) 


fault. abort: generate an IOT - abort(3C) 
absolute value. abs: return integer . 2... abs(3C) 
adb: absolute debugger. - » adb(1) 
abs: return integer absolute value. ... 2. abs(3C) 
ceiling, remainder, absolute value/ /floor, . . . floor(3M) 
tiop: terminal accelerator interface. . .. - tiop(7) 


socket. accept: 
connection on a socket. 


accept a connection on a 
accept: accept a 


- accept(2N) 
- accept(2N) 


allow/prevent LP/ accept, reject: . 2... ee > accept(1M) 
times of / touch: update access and modification . . touch(1) 
times. utime: set file access and modification . . utime(2) 
accessibility of a/ access: determine .....~ access(2) 
numerical/ graphics: access graphical and .. . - graphics(1G) 
drvalloc, drvbind: access loadable drivers. . . . Iddrv(2) 
in a/ sputl, sgetl: access long integer data « sputl(3X) 
sadp: disk access profiler. .. +... + sadp(1M) 
common object file access routines. Idfen: - - Idfen(4) 
file systems for optimal access time. /copy - + deopy(1M) 
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locking: exclusive 
/endutent, utmpname: 
access: determine 

or disable process 
acctcon2: connect-time 
acctpre2: process 

shell procedures for 
acctwtmp: overview of 
/and miscellaneous 
diskusg: generate disk 
acct: per-process 
/search and print process 
/merge or add total 
/summary from per-process 
/manipulate connect 
runacct: run daily 
process accounting. 
accounting file format. 
from per-process/ 
print process/ 
connect-time/ 
accounting. acctconl, 
aceton, acctwtmp:/ 
acctwtmp:/ acctdisk, 
total accounting files. 
acctdisk, acctdusg, 
process accounting. 
accounting. acctprel, 
/acctdusg, accton, 

sin, cos, tan, asin, 
killall: kill all 

sag: system 

sal, sa2, sade: system 
sar; system 

SCCS file editing 
process data and system 
protocols. Dialers: 
hopefully interesting, 


acctmerg: merge or 
putenv: change or 

/set DARPA Internet 
/inet_netof: Internet 
setenet: write Ethernet 
administer SCCS files. 
admin: create and 
interface. swap: swap 
Cave. 

alarm: set a process 
alarm clock. 

data segment space 
calloc: main memory 
fast main memory 
accept, reject: 

running process/ renice: 
sort: sort 

and link editor output. 
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access to regions of a/ .. 
access utmp file entry. . . 
accessibility of afile. . ... 
accounting. /enable .... 
accounting. acctconl, ... 
accounting. acctprcl, ... 
accounting. /turnacct: eee 
accounting and/ /accton, . 
accounting commands. ... 
accounting data by user/ . . 
accounting file format. ... 
accounting file(s). 
accounting files. . 2. 2 2. « « 
accounting records. .... 
accounting records. .... 
accounting. . 2. 2. 6 eee 
acct: enable or disable .. . 
acct: per-process 
acctems: command summary 
acctcom: search and .... 
acctconl, acctcon2: .... 
acctcon2: connect-time ... 
acctdisk, acctdusg, ... « 
acctdusg, accton, 
acctmerg: merge oradd .. 
accton, acctwtmp:/  ...- 
acctprel, acctpre2: . . 2 « 
acctpre2: process 
acctwtmp: overview of/ .. 
acos, atan, atan2:/ 
active processes. . . . - » « 
activity graph. 
activity report package. . . 
activity reporter. 
activity. /print current .. 
activity. /report 
ACU/modem calling ... . 
adage. /print arandom, . . 
adb: absolute debugger. .. 
add total accounting/ ... 
add valueto/ . 2... ee. 
address from node name. . . 
address manipulation/ .. . 
address on disk. 

admin: create and 
administer SCCS files. . . . 
administrative ... +e 
advent: explore Colossal .. 
alarm clock. 
alarm: set a process . . « » 
allocation. /change ...- 
allocator. /realloc, ...- 
allocator. /mallinfo: ... 
allow/prevent LP/ ....- 
alter priority of 
and/or merge files. . . «+ 
a.out: common assembler . . 


oe ee 


oe we ew © 


oe @ ee 


locking(2) 
getut(3C) 
access(2) 
acct(2) 
acctcon(1M) 
acct pre(1M) 
acctsh(1M) 
acct(1M) 
acct(1M) 
diskusg(1M) 
acct(4) 
acctcom(1) 
acctmerg(1M) 
acctcms(1M) 
fwtmp(1M) 
runacct(1M) 
acct (2) 
acct(4) 
acctems(1M) 
acctcom(1) 
acctcon(1M) 
acctcon(1M) 
acct(1M) 
acct(1M) 
acctmerg(1M) 
acct(1M) 
acctpre(1M) 
acctpre(1M) 
acct(1M) 
trig(3M) 
killall(1M) 
sag(1G) 
sar(1M) 
sar(1) 
sact(1)} 
timex(1) 
Dialers(5) 
fortune(6) 
adb(1) 

acct merg(1M) 
putenv(3C) 
setaddr(iNM) 
inet(3N) 
setenet(1NM) 
admin(1) 
admin(1) 
swap(1M) 
advent(6) 
alarm(2) 
alarm(2) 
brk(2) 
malloc(3C) 
malloc(3X) 
accept(1M) 
renice(1) 
sort(1) 
a.out(4) 


/to commands and 
maintainer for portable/ 
format. 

number: convert 
arithmetic/ be: 
maintainer for/ ar: 
cpio: format of cpio 

ar: common 

header of a member of an 
{convert object and 
Idahread: read the 

tar: tape file 

maintainer for portable 
cpio: copy file 

varargs: handle variable 
foutput of a varargs 
xargs: construct 

/get option letter from 
expr: evaluate 

echo: echo 

be: arbitrary-precision 
drill in number facts. 
expr: evaluate arguments 


/and detach serial lines 
/locate a terminal to use 
asa: interpret 

carriage control/ 

ascii: map of 

hd: hexadecimal and 
character set. 

long integer and base-64 
atof: convert 

strings: extract the 
date/ /localtime, gmtime, 
sin, cos, tan, 

help: 

editor/ a.out: common 
as: 

assertion. 

assert: verify program 
setbuf, setvbuf: 

out the list of blocks 
commands at a later/ 
cos, tan, asin, acos, 
/tan, asin, acos, atan, 
string to/ 

strtod, 

integer. strtol, atol, 
string to/ strtol, 
slattach, sldetach: 
process. wait: 

and processing/ 
ungetec: push character 
backgammon. 

back: the game of 

fine: fast incremental 
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application programs. . 
ar: archive and library . 
ar: common archive file 

Arabic numerals to/ . . 
arbitrary-precision .. . 
archive and library . . 
archive. . 2 ees 
archive file format. . . 
archive file. /archive . 
archive files to common / 
archive header of a/ . . 
archiver. . . 2 oe © « 
archives. /and library . 
archives in and out. . . 
argument list. . 2. «6 « 
argument list. . 2... 
argument list(s) and/ .. 
argument vector. . « « 
arguments asan/ .. . 
arguments. 
arithmetic language. . . 
arithmetic: provide . . 
as an expression. .. . 
as: assembler. . . 2 se 
as network interfaces. . 
as the virtual system/ . 
ASA carriage control/ . 
asa: interpret ASA we 
ASCII character set. . . 
ascii file dump. 
ascii: map of ASCIE .. 
ASCII string. /between 

ASCII string to/ ... 
ASCII text strings in a/ 

asctime, tzset: convert . 
asin, acos, atan, atan2:/ 

ask for help. 
assembler and link .« 
assembler. 
assert: verify program 
assertion. « » . + « « 
assign buffering toa/ . 
associated with/ /print 
at, batch: execute ... 
atan, atan2:/ sin, ... 
atan2: trigonometric/ . 
atof: convert ASCH . . 
atof: convert string to/ . 
atoi: convert string to. 
atol, atoi: convert 
attach and detach serial / 
await completion of . . 
awk: pattern scanning . 
back into input stream. 

back: the gameof ... 
backgammon. ...-. - 
backup. 


ee ee 


intro(1) 

ar(1) 

ar(4) 
number(6) 
be(1) 

ar(1) 

epio(4) 

ar(4) 
ldahread(3X) 
convert(1) 
ldahread(3X) 
tar(1) 


vprintf(3S) 
xargs(1) 
getopt(3C) 
expr(1) 
echo(1) 

be(1) 
arithmetic(6) 
expr(1) 

as(1) 
slattach(1NM) 
conlocate(1M) 
asa(1) 

asa(1) 

ascii(5) 

hd(1) 

ascii(5) 
a641(3C) 
atof(3C) 
strings(1) 
ctime(3C) 


assert(3X) 
set buf(3S) 
bcheck(1M) 


strtod(3C) 
strtol(3C) 
strtol(3C) 
slattach(1NM) 
wait(1) 

awk(1) 
ungetc(3S) 
back(6) 
back(6) 
finc(1M) 


recover files from a 


terminal capability data 
terminal capability data 
/between long integer and 
/(visual) display editor 
proto file; set links 
deliver portions of / 

at a later time. at, 
arithmetic language. 

list of blocks/ 

drvload: system/ bre, 
copy. 


eb: C program 
JO, j1, jn, yO, yl, yn: 


/install object files in 
fread, fwrite: 

table. bsearch: 
/tdelete, twalk: manage 
bind: 

socket. 

jack. 

bj: the game of 

beopy: interactive 

sum: print checksum and 
sync: update the super 
/print out the list of 
number of free disk 
manipulate Volume Home 
powerfail, drvload:/ 
segment space/ 

sorted table. 

stdio: standard 

setbuf, setvbuf: assign 
mknod: 

yme: VME 

between host and network 
swab: swap 

ce: 

cflow: generate 

cpp: the 

includes: determine 

cb: 

lint: a 

exref: generate 

ctrace: 

and share strings in 
cprofile: setting up a 


de: desk 

cal: print 

service. 

system. cu: 

returned by stat system 
Dialers: ACU/modem 
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backup tape. frec: .. 2. © 
banner: make posters. ... 
base. termcap: .....-. 
base. terminfo: ...... 
base-64 ASCII string. ... 
based on ex. 
based on. /lists from ... 
basename, dirname: 
batch: execute commands 
be: arbitrary-precision . 
bcheck: print out the ... 
bcheckre, rc, powerfail, . . . 
beopy: interactive block .. 
bdiff: big diff... ..... 
beautifier. 
Bessel functions. ..... 
bfs: big filescanner. .... 
binary directories. 
binary input/output. ... 
binary search a sorted 


ee ee wo eo 


frec(1M) 
banner(1) 
termcap(4) 
terminfo(4) 
a641(3C) 
vi(1) 

qlist(1) 
basename(1) 


- at(1) 
- be(1) 


beheck(1M) 
bre(1M) 
beopy(1M) 
bdiff(1) 


- cb(1) 


bessel(3M) 
bfs(1) 
cpset(1M) 
fread(3S) 


. bsearch(3C) 


binary search trees. . . . . tsearch(3C) 
bind a name toa socket. . . bind(2N) 
bind: bind a name toa .. . bind(2N) 
bj: the game of black . . ~ bj(6) 

black jack, . . 2. + + + « bj(6) 

block copy. . . - « « + + + beopy{1M) 
block count of a file. . . . . sum(1) 
block. 2... ee ee ee © syne(l) 
blocks associated with/ . . bcheck(1M) 
blocks. df: report... . . df(1M) 
Blocks (VHB). libdev: . . . libdev(3X) 
bre, bcheckre, re, . . ~~~ bre(1M) 
brk, sbrk: change data . . . brk(2) 
bsearch: binary search a . . bsearch(3C) 
buffered input/output/ . . stdio(3S) 
buffering toastream. . . . setbuf(3S) 
build special file. .. . . . mknod(1M) 
bus interface. . . . «+. + vme(7) 
byte order. /values .. . . byteorder(3N) 
bytes. 2. eee ee wees swab(3C) 
C compiler. «2... 2 eee ec(1) 

C flowgraph. . 2... eee eflow(1) 

C language preprocessor. - cpp(1) 

C language preprocessor/ . . includes(1) 
C program beautifier. . . . cb(1) 

C program checker. . ~~ « lint(1) 

C program/ ......- exref(1) 

C program debugger. .. ~ ctrace(1) 
C programs. /extract . . . xstr(1) 


C shell environment at/ . 


- cprofile(4) 


cal: print calendar. .. . . cal(1) 
calculator, 2... ee eee de(1) 
calendar. - .. +... cal(l) 
calendar: reminder . . . . . calendar(1) 
call another computer .. . cu(1C) 
call. stat:data ..... . stat(5) 
calling protocols. ..... Dialers(5) 


malloc, free, realloc, 
malloc, free, realloc, 
/introduction to system 
link and unlink system 
requests to an LP/ Ip, 
termcap: terminal 
terminfo: terminal 

asa: interpret ASA 
(variant of ex for 

print files. 

catman: create the 

files for the manual. 
advent: explore Colossal 
beautifier. 


directory. 

commentary of an SCCS/ 
ceiling,/ floor, 

/ceil, fmod, fabs: floor, 
flowgraph. 

delta: make a delta 

of running process by 
create an interprocess 
terminal’s local RS-232 
input/ ungete: push 
for/ eqnchar: special 
the user. cuserid: get 
/fgetc, getw: get 
/fpute, putw: put 

ascii: map of ASCII 
ASA carriage control 
toascii: translate 
isascii: classify 

tr: translate 

dodisk, lastlogin, / 
directory. 

/file system consistency 
directories/ uucheck: 
constant-width text/ cw, 
mathematical/ eqn, neqn, 
lint: a C program 
password /group file 

file systems with label 
systems processed by/ 
documents/ mm, osdd, 
of a file. sum: print 
group. chown, 

times: get process and 
wait: wait for 


file. 

group of a file. 
owner or group. 
directory. 

directory for a/ 
lastlogin,/ chargefee, 
/iscntrl, isascii: 
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calloc: main memory/ . . 
calloc, mallopt,/ ..... 
calls and error numbers. . 
calls. /unlink: exercise . . 
cancel: send/cancel .. « 
capability data base. .. . 
capability data base. .. . 
carriage control/ .... 
casual users). /editor . . 
cat: concatenate and .. . 
cat files forthe/ ....- 
catman: create the cat .. 
Cave. 
eb: C program 
ec: C compiler. 
cd: change working ... 
cde: change the delta .. 
ceil, fmod, fabs: floor, .. 
ceiling, remainder,/ ... 
cflow: generateC .... 
(change) to an SCCS/ .. 
changing nice. /priority . 
channel. pipe: 
channels. /controlling . . 
character back into ... 
character definitions ... 
character login name of . 
character or word from a/ 
character or word ona/ . 
character set. . «6 eo « 
characters. /interpret .. 
characters. /_tolower, . . 
characters. /iscntrl, .. + 
characters. . 2 + ee ee 
chargefee, ckpacct, ... 
chdir: change working .. 
check and interactive/ . . 
check the UUCP ... 
checkcw: prepare ... 
checkeq: format 
checker. 2. 2. 2 ee ae 
checkers. pwek, grpck: . . 
checking. /labelit: copy 

checklist: list of file ... 
checkmm: print/check . . 
checksum and block count 
chgrp: change owner or. 
child process times. .. « 
child process to stop or/ . 
chmod: change mode. .. 
chmod: change mode of . 
chown: change owner and 

chown, chgrp: change .. 
chroot: change root ... 
chroot: change root ... 
ckpacct, dodisk, . 2... > 
classify characters. es 


malloc(3C) 
malloe(3X) 


termcap(4) 
ter minfo(4) 
asa(1) 
edit(1) 
cat(1) 
catman(1) 
catman(1) 
advent(6) 
eb(1) 

ec(1) 

ed(1) 

cde(1) 
floor(3M) 
floor(3M) 
cflow(1) 
delta(1) 
renice(1) 
pipe(2) 
tp(7) 
ungetc(3S) 
eqnchar(5) 
cuserid(3S) 
getc(3S) 
pute(3S) 
ascii(5) 
asa(1) 
conv(3C) 
ety pe(3C) 
tr(1) 
acctsh(1M) 
chdir(2) 
fsck(1M) 
uucheck(1M) 
ew(1) 

eqn(1) 
lint(1) 
pwek(1M) 
volcopy(1M) 
checklist(4) 
mm(1) 
sum(1) 
chown(1)} 
times(2) 
wait(2) 
chmod(1) 
chmod(2) 
chown(2) 
chown(1) 
chroot(2) 
chroot(1M) 
acctsh(1M) 
ety pe(3C) 


uucp spool directory 
screen. 

elri: 

clear: 

status/ ferror, feof, 
interpreter) with 
set a process alarm 
cron: 

used. 

Idclose, Idaclose: 
close: 

descriptor. 

fclose, fflush: 


line-feeds. 

advent: explore 

deltas. 

comb: 

lines common to two/ 
nice: run a 

root directory for a 

env: set environment for 
remd: remote shell 

uux: CTIX to CTIX remote 
hangups/ nohup: run a 
with/ csh: a shell 
getopt: parse 

executable file for 

/the standard /restricted 
a stream to a remote 
data and/ timex: time a 
uuxqt: execute remote 
stream to a remote 
per-process/ acctcms: 
system: issue a shell 
condition evaluation 
time: time a 

list(s) and execute 
miscellaneous accounting 
intro: introduction to 
at, batch: execute 
graphical and numerical 
install: install 

mkhosts: make node name 
useful with graphical 
ede: change the delta 
format. ar: 

link editor/ a.out: 

and archive files to 
access routines. Idfcn: 
Idopen, Idaopen: open a 
/line number entries of a 
/\daclose: close a 

/the file header of a 

/of a section of a 

/file header of a 
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clean-up. uucleanup: . . 
clear: clear terminal 
clear i-node. 
clear terminal screen. . . 
clearerr, fileno: stream .. 
C-like syntax. /(command 
clock. alarm: 
clock demon. 
clock: report CPU time. 
close a common object/ . 
close a file descriptor. . . 
close: close afile ..... 
close or flush a stream. . . 
clri: clear i-node. 
cmp: compare two files. . 
col: filter reverse ... 
Colossal Cave. 
comb: combine SCCS .. 
combine SCCS deltas. .. 
comm: select or reject . . 
command at low priority. 
command. chroot: change 
command execution. 
command execution. . . 
command execution. .. - 
command immuneto .. 
(command interpreter) . . 
command options. . .. - 
command. path: locate . 
command programming/ . 
command. /for returning 
command; report process 
command requests. 
command. rexec: return 
command summary from 
command. 
command. test: 
command. 
command. /argument . . 
commands. /and 
commands and application/ 
commands at a later/ 
commands. /access .. - 
commands. 
commands. 
commands. /network . . 
commentary of an SCCS/ 
common archive file 
common assembler and. 
common formats. /object 
common object file 
common object file for/ . 
common object file/ ... 
common object file. ... 
common object file. .. . 
common object file. ... 
common object file. .. . 


. 
eee 

. 
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uucleanup(1M) 
clear(1) 
elri(1M) 
clear(1) 
ferror(3S) 
esh(1) 
alarm(2) 
cron(1M) 
clock(3C) 
ldelose(3X) 
close(2) 
close(2) 
fclose(3S) 
clri(1M) 
emp(1) 
col(1) 
advent(6) 
comb(1) 
comb(1) 
comm(1) 
nice(1) 
chroot(1M) 
env(1) 


timex(1) 
uuxqt(1M) 
rexec(3N) 
acctems(1M) 
system(3S) 
test(1) 
time(1) 
xargs(1) 
acct(1M) 
intro(1) 
at(1) 
graphics(1G) 
install(1M) 
mk hosts(1NM) 
stat(1G) 
ede(1) 

ar(4) 
a.out(4) 
conyvert(1) 
Idfen(4) 
Idopen(3X) 
Idlread(3X) 
Idclose(3X) 
Idfhread(3X) 
Idlseek(3X) 
Idohseek(3X) 


/of a section of a 
/section header of a 
/section of a 

symbol table entry of a 
/symbol table entry of a 
/to the symbol table of a 
/line number entries in a 
nm: print name list of 
/information for a 
/section header for a 
/information from a 
/retrieve symbol name for 
symbol table/ syms: 
filehdr: file header for 
Id: link editor for 

/print section sizes of 
/select or reject lines 
/report inter-process 
/standard interprocess 
create an endpoint for 
/file for uucp 

diff: differential file 
emp: 

an SCCS file. scesdiff: 
3-way differential file 
diremp: directory 
reguiar/ regcemp, regex: 
/regular expression 
regular expression 

term: format of 

ce: C 

tic: terminfo 

yacc: yet another 

/erfe: error function and 
wait: await 

pack, peat, unpack: 
symbol table/ Idtbindex: 
eu: call another 

files. cat: 

command. test: 

system. 

uucp/ Devices: 

config: 

interface/ ifconfig: 
spooling/ Ipadmin: 
terminal to use as the/ 
/wtmpfix: manipulate 
connection on a socket. 
getpeername: get name of 
out-going terminal line 
accept: accept a 
connect: initiate a 

part of a full-duplex 
listen: listen for 
acctconl, acctcon?2: 
fsck, dfsck: file system 
as the virtual system 
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common object file. . . 
common object file. . . 
common object file. . . 
common object file. /a 

common object file. . . 
common object file. . . 
common object file. . . 
common object file. . . 
common object file. .. 
common object file. .. 
common object file. . . 
common object file/ . . 
common object file .. 
common object files. . . 
common object files. . . 
common object files. . . 
common to two sorted/ 

communication facilities/ 
communication package. 
communication. socket: 

communications lines. . 
comparator. 
compare two files. 
compare two versions of 

comparison. diff: .. . 
comparison. 
compile and execute . . 
compile and match/ . . 
compile. regemp: .. « 
compiled term file. . . 
compiler. 
compiler. 
compiler-compiler. . . . 
complementary error/ . 
completion of process. . 
compress and expand/ . 
compute the index of a . 
computer system. 
coucatenate and print’ . 
condition evaluation . . 
config: configure a CTIX 
configuration file for . . 
configure a CTIX system. 
configure network 
configure the LP... 
conlocate: locatea .. . 
connect accounting/ .. 
connect: initiatea .. . 
connected peer. . . se 
connection. /an .... 
connection on a socket. 

connection on a socket. 

connection. /shut down 

connections on a socket. 

connect-time accounting. 
consistency check and/ . 
console. /touse ... - 


oe e we we we 
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ldrseek(3X) 
\dshread(3X) 
Idsseek(3X) 
Idtbindex(3X) 
Idtbread(3X) 
ldt bseek(3X) 
linenum(4) 
nm(1) 

reloc(4) 
senhdr(4)} 
strip(1) 
Idgetname(3X) 
syms(4) 
filehdr(4) 

1d(1) 

size(1) 
comm(1) 
ipes(1) 
stdipe(3C} 
socket(2N) 
Devices(5) 
diff(1) 

emp(1) 
secsdiff(1) 
diff'3(1) 
diremp(1) 
regemp( 
regexp(5) 


Idt bindex(3X) 
cu(1C) 

cat(1) 

test(1) 
config(1M) 
Devices(5) 
config(1M) 
ifconfig( 1NM) 
lpadmin(1M) 
conlocate(1M) 
fwtmp(1M) 
connect(2N) 
getpeername(2N) 
dial(3C) 
accept(2N) 
connect(2N) 
shutdown(2N) 
listen(2N) 
acctcon(1M) 
fsck(1M) 
conlocate(1M) 


terminal. 

console: 

math: math functions and 
cw, checkcew: prepare 
mkfs: 

list(s) and/ xargs: 
/tbl, and eqn 

with/ Uutry: try to 

Is: list 

toc: graphical table of 
esplit: 

/interpret ASA carriage 
ioctl: 

fentl: file 

init, telinit: process 
msgctl: message 

semctl: semaphore 
shmctl: shared memory 
fentl: file 

status inquiry and job 
ve: version 

772 half-inch tape 
interface. tty: 

local RS-232/ tp: 
terminals. term: 

units: 

dd: 

to English. number: 
floating-point/ atof: 
integers/ 13tol, ltol3: 
integer and/ a64l, 164a: 
and archive files to/ 
/gmtime, asctime, tzset: 
ecvt, fevt, gevt: 

scanf, fscanf, sscanf: 
archive files/ convert: 
strtod, atof: 

strtol, atol, atoi: 
/htons, ntohl, ntohs: 
dd: convert and 

beopy: interactive block 
and out. cpio: 

optimal access/ dcopy: 
label/ volcopy, labelit: 
files. ep, In, my: 

rep: remote file 

system to CTIX system 
CTIX-to-CTIX system file 
for the UUCP/ uucico: 
image file. 

core: format of 

atan, atan2:/ sin, 
functions. sinh, 

print checksum and block 
we: word 

or move files. 

cpio: format of 


5/86 


console: console .... 
console terminal. ... 
constants. «2. 222. 
constant-width text for/ 
construct a file system. . 
construct argument. . 
constructs. . ....«-s 
contact a remote system 
contents of directory. . 
contents routines. .. . 
context split. 
control characters. . . . 
control device. ... 
control, 2... 2 eee 
control initialization. . . 
control operations. . . 
control operations. .. 
control operations. . . 
control options. .... 
control. uustat: uucp . 
control. 
controller. /Xylogics . . 
controlling terminal . . 
controlling terminal’s . 
conventional names for . 
conversion program. . . 
convert and copy a file. 
convert Arabic numerals 
convert ASCII string to 
convert between 3-byte 
convert between long. 
convert: convert object . 
convert date and time to/ 
convert floating-point/ . 
convert formatted input. 
convert object and .. 
convert string to/ 
convert string to/ 
convert values between/ 
copy a file. 
copy. 
copy file archivesin .. 
copy file systems for . . 
copy file systems with . 
copy, link or move... 
copy. 
copy. uucp:CTIX ... 
copy. /uupick: public . 
copy-in/copy-out program 
core: format of core . . 
core image file. 
cos, tan, asin, acos, . - 
cosh, tanh: hyperbolic . 
count of a file. sum: . . 
count. 
cp, In, my: copy, link . 
cpio archive. 


oe ee 


ee ee we ew 
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oe © we we ew ew 


console(7) 
console(7) 
math(5) 
ew(1) 
mkfs(1M) 
xargs(1) 
deroff(1) 
Uutry(1M) 
Is(1) 
toc(1G) 
esplit(1) 
asa(1) 
ioctl(2) 
fentl(2) 
init(IM) 
msgctl(2) 
semctl(2) 
shmctl(2) 
fentl(5) 
uustat(1C) 
ve(1) 
xmset(1M) 
tty(7) 
tp(7) 
term(5) 
units(1) 
dd(1) 
number(6) 
atof(3C) 
13tol(3C) 
a64i(3C} 
convert(1) 
ctime(3C) 
ecyt(3C) 
scanf(3S) 
convert(1) 
strtod(3C) 
strtol(3C) 
byteorder(3N) 
dd(1) 
beopy(1M) 
epio(1) 
deopy(1M) 
volcopy(1M) 
ep(1) 
rep(1N) 
uucp(1C) 
uuto(1C) 
uucico(1M) 
core(4) 
core(4) 
trig(3M) 
sinh(3M) 
sum(1) 
we(1) 
cp(1) 
epio(4) 


in and out. 

archive. 

preprocessor. 

shell environment at/ 
files in binary / 

clock: report 

craps: the game of 
craps. 

images. 

or rewrite an existing/ 
tmpnam, tempnam: 
rewrite an/ creat: 
fork: 

ctags: 

tmpfile: 
communication. socket: 
channel. pipe: 

SCCS files. admin: 
the manual. catman: 
umask: set and get file 


file. 

crontab - user 
generate C program 
optimization/ curses: 
generate hashing/ 
interpreter) with/ 


remote terminal. 

file. 

name for terminal. 
gmtime, asctime, tzset:/ 
software. 

execution. uux: CTIX to 
config: configure a 

uucp: CTIX system to 
system copy. uucp: 
print name of current 
get name of current 
command execution. uux: 
uuto, uupick: public 
debugger. 

computer system. 

tit, 

uname: print name of 
uname: get name of 
gethostname: get name of 
editing/ sact: print 

in the utmp file of the 
getcwd: get path-name of 
handling and/ 
interpolate smooth 

login name of the user. 
fields of each line of / 

of each line of a/ cut: 
constant-width text for/ 
program/ 


5/86 


cpio: copy file archives . . 
cpio: format of cpio ... 
cpp: the C language ... 
cprofile: setting upaC .. 
cpset: install object . . . 
CPU time used. ..... 
craps. 
craps: the gameof .... 
crash: examine system . . 
creat: create a new file .. 
create a name for a/ .. . 
create a new fileor . . « 
create a new process. oe 
create a tags file. .... 
create a temporary file. . 
create an endpoint for .. 
create an interprocess .. 
create and administer . . 
create the cat files for .. 
creation mask. ....-. 
cron: clock demon. ... 
crontab - user crontab .. 
crontab file. 
cross-reference. cxref: . . 
CRT screen handling and 

crypt, setkey, encrypt: .. 
csh: a shell (command .. 
esplit: context split. . .. 
ct: spawn getty toa ... 
ctags: create atags .. . 
ctermid: generate file .. 
ctime, localtime, ....- 
ctinstall: install 
CTIX remote command . 
CTIX system. . . 2... 
CTIX system copy. ... 
CTIX system toCTIX .. 
CTIX system. uname: .. 
CTIX system. uname: .. 
CTIX to CTIX remote .. 
CTIX-to-CTIX system file/ 
ctrace: C program ...- 
cu: call another ..... 
cubic: tic-tac-toe. . .. 
current CTIX system. .. 
current CTIX system. 


ee © eo we we we ow 


current host. . 2.26 eas 
current SCCS file .... 
current user. /the slot . . 


current working/ 
curses: CRT screen ...~ 
curve. spline: 2. + ee « 
cuserid: get character .. 
cut: cut out selected . .. 
cut out selected fields .. 
ew, checkcw: prepare .. 
exref: generate C 


epio(1)} 
epio(4) 
epp(1) 
eprofile(4) 
cpset(1M) 
clock(3C) 
craps(6) 
craps(6) 
crash(1M) 
creat(2) 
tmpnam(3S) 
creat(2) 
fork(2) 
ctags(1) 
tmpfile(3S) 
socket(2N) 
pipe(2) 
admin(1) 
catman(1) 
umask(2) 
cron(1M) 
crontab(1) 
crontab(1) 
exref(1) 
curses(3X) 
ery pt(3C) 
esh(1) 
esplit(1) 
et(1C) 
etags(1) 
ctermid(3S) 
ctime(3C) 
ctinstall(1) 
uux(1C) 
config(1M) 
uucp(1C) 
uucp(1C) 
uname(1) 
uname(2) 
uux(1C) 
uuto(1C) 
ctrace(1) 
cu(1C) 
ttt(6) 
uname(1) 
uname(2) 
gethostname(3N) 
sact(1) 
ttyslot(3C) 
getewd(3C) 
curses(3X) 
spline(1G) 
cuserid(3S) 
cut(1) 
cut(1) 
ew(1) 
exref(1) 


runacct: run 

from node/ setaddr: set 
Transfer Protocol/ ftpd: 
server. telnetd: 

/user interface to the 
Transfer/ tftpd: 
/special functions of 
/special functions of the 
command; report process 
terminal capability 
terminal capability 
generate disk accounting 
access long integer 

lock process, text, or 
prof: display profile 
system call. stat: 

brk, sbrk: change 

types: primitive system 
join: relational 

the mkfs(1) proto file 
tput: query terminfo 
/asctime, tzset: convert 
date: print and set the 
date. 


for optimal access/ 

file. 

adb: absolute 

ctrace: C program 
fsdb: file system 

sdb: symbolic 

a remote system with 
neqn. /special character 
basename, dirname: 

a file. tail: 
commentary of an SCCS 
SCCS/ delta: make a 
SCCS/ cde: change the 
rmdel: remove a 
(change) to an SCCS/ 
comb: combine SCCS 
cron: clock 

errdemon: error-logging 
the error-logging 

mesg: permit or 
nroff/troff, tbl, and/ 
system: system 

close: close a file 
duplicate an open file 
de: 

/sldetach: attach and 
of a file. access: 
preprocessor/ includes: 
file: 

drivers: loadable 

for finite width output 
table. master: master 
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daily accounting. 
DARPA Internet address .. 
DARPA Internet File ... 
DARPA TELNET protocol 
DARPA TFTP protocol. .. 
DARPA Trivial File 


- Tunacct(1M) 


setaddr(1NM) 
ftp d(1NM) 


. telnetd(1NM) 


tftp(1N) 


. tftpd(1NM) 


DASI 300 and 300s/ . . . . 300(1) 
DASI 450 terminal. . . . . 450(1) 
data and system/ /timea . timex(1) 
data base. termcap: . . . . termcap(4) 
data base. terminfo: . . . . terminfo(4) 
data by user ID. . . . . . . diskusg(1M) 
data in a/ sputl, sgetl: . . . sputl(3X) 
data in memory. plock: . . plock(2) 
data. 2. 2... eee ee © prof(l) 
data returned by stat .. . stat(5) 
data segment space/ . .. . brk(2) 
data types. . . 2+... « types(5) 
database operator. .. 2... join(1) 
database. /using ..... qinstall(1) 
database. . 2 2 eee eae tput(1) 
date and time to string. - ctime(3C) 
Gates io Se eee Be Gane ts date(1) 
date: print and set the . . . date(1) 
de: desk calculator. .. . . de(1) 
dcopy: copy file systems . . dcopy(1M) 
dd: convert and copya ... dd(1) 
debugger. .... +... adb(l) 
debugger. . «+ + + + + « ctrace(1) 
debugger. .. +--+ + fsdb(1M) 
debugger. .. ++. +. sdb(l) 
debugging on. /contact . . Uutry(1M) 
definitions for eqn and .. . eqnchar(5) 
deliver portions of path/ . . basename(1) 
deliver the last part of . . . tail(1) 
delta. /change the delta - cede(1) 
delta (change) to an .. . © delta(1) 
delta commentary of an ede(1) 
delta from an SCCS file. rmdel(1) 
delta: make adelta ... . delta(1) 
deltas. 2. 6 ee sea eas comb(1) 
demon. . 2 2 ee ee eee cron(1M) 
demon... +.» . - errdemon(1M) 


demon. /terminate 
deny messages. 
deroff: remove 
description file. 
descriptor. 
descriptor. dup: 
desk calculator. 
detach serial lines as/ 
determine accessibility 
determine C language 
determine filetype. .... 
device drivers. 
device. /fold long lines . . . 
device information 
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- errstop(1M) 


mesg(1) 
deroff(1) 
system(4) 
close(2) 
dup(2) 
de(1) 


- slattach(1NM) 
- access(2) 
- includes(1) 


file(1) 


- drivers(7) 


fold(1) 
master(4) 


ioctl: control 

deynm: 

/tekset, td: graphical 
file for uucp/ 


free disk blocks. 
consistency check/ fsck, 
out-going terminal line/ 
calling protocols. 

bdiff: big 

comparator. 

differential file/ 

sdiff: side-by-side 

files. diffmk: mark 
comparator. diff: 

diff3: 3-way 

between files. 
directories. 

comparison. 

uucheck: check the UUCP 
object files in binary 
dir: format of 

rmdir: remove files or 
cd: change working 
chdir: change working 
chroot: change root 
uucleanup: uucp spool 
diremp: 

unlink: remove 

chroot: change root 
make a lost+found 

of current working 

1s: list contents of 
mkdir, mkdirs: make a 
mvdir: move a 

pwd: working 

or/ mknod: make a 
portions of/ basename, 
LP printers. enable, 
acct: enable or 

modes, speed, and line 
modes, speed, and line 
sadp: 

user/ diskusg: generate 
report number of free 
remove exchangeable 
disk: general 

driver. 

Ethernet address on 
update: provide 

du: summarize 
accounting data by user/ 
mount, umount: mount and 
exchangeable disk. 
/screen-oriented (visual) 
prof: 

on local/ ruptime: 
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device. . 2. 
device name. 


joctl(2) 


. devnm(1M) 


device routines and/ . . . . gdev(1G) 
Devices: configuration . . . Devices(5) 
devnm: device name... . devnm(1M) 
df: report number of . . . . df(1M) 
dfsck: filesystem ... . . fsck(1M) 
dial: establish an... . . dial(3C) 
Dialers: ACU/modem . . . Dialers(5) 
diff, 2. 2 ee ew we oo © DENI) 
diff: differential file . . . . diff(1) 
diff: 3-way 2... e eee diff3(1) 
difference program. .. . . sdiff(1) 
differences between .. . . diffmk(1) 
differential file ... . . . diff(1) 
differential file/ ...-... diff3(1) 
diffmk: mark differences . . diffmk(1) 
dir: format of . ...... dir(4) 
diremp: directory ... . . dircmp(1) 
directories and/ ... .. . uucheck(1M) 
directories. /install . . . . cpset(1M) 
directories. . 2. eee ~ dir(4) 
directories. rm, 2... e+ rm(1) 
directory, ....- - « . ed(1) 
directory. see ee © © chdir(2) 
directory. «+. ++ + chroot(2) 
directory clean-up. . . . . uucleanup(1M) 
directory comparison. .. . dircmp(1) 
directory entry. 2... - . . unlink(2) 
directory for a command. . . chroot(1M) 
directory for fsck. . . . . . mklost+found({1M) 
directory. /path-name .. . getcwd(3C) 
directory. . 2.2... Is(l) 
directory, .. +... +.» mkdir(1) 
directory. «+. +... «+. mvdir(1M) 
directory name. ... +... pwd(t) 
directory, or a special . . . mknod(2) 
dirname: deliver . . . . . . basename(1) 
disable: enable/disable . . . enable(1) 
disable process/ ... - ~ ~ acct(2) 
discipline. /type, . +... . getty(1M) 
discipline. /type, . +... uugetty(1M) 
disk access profiler. . . . . sadp(1M) 
disk accounting data by . diskusg(1M) 
disk blocks. df: ... es. df(1M) 
disk. dismount: ...... dismount(1) 
disk driver. coe - disk(7) 
disk: general disk ..... disk(7) 

disk. setenet: write . . . . setenet(1NM) 
disk synchronization. . . . update(1M) 
disk usage. . . 2 ee eee du(1) 


diskusg: generate disk 


. diskusg(1M) 


dismount file system. . . . mount(1M) 
dismount: remove .. . . - dismount(1) 
display editor based on/ » vi(1) 
display profile data. - - prof(t) 


display status of nodes 


A he 


- » ruptime(1N) 


hypot: Euclidean 
generate uniformly 
/checkmm: print/check 
package for formatting 
and/ mmt, mvt: typeset 
chargefee, ckpacct, 
whodo: who is 

/atof: convert string to 
ptdl: RS-232 terminal 
lrand48, nrand48, / 
graph: 

arithmetic: provide 
Xylogics 772/ xmset: set 
disk: general disk 

sxt: pseudo-device 
make a loadable 
drivers: loadable device 
/manage loadable 
drvbind: access loadable 
drivers. 

access loadable/ 
drivers. drvalloc, 
bcheckre, rc, powerfail, 
usage. 

parts of an object/ 
status information from 
and ascii file 

od: octal 

an object file. dump: 
file descriptor. 
descriptor. dup: 

echo: 


convert floating-point / 


program. end, etext, 
(variant of ex for/ 
print current SCCS file 
/(visual) display 

ed, red: text 

ex: text 

files. Id: link 

ged: graphical 
assembler and link 
sed: stream 

for casual/ edit: text 
Ideeprom: load 

/user, real group, and 
/getegid: get real user, 
FORTRAN, ratfor, or 
file for a/ grep, 
enable/disable LP / 
process/ acct: 

enable, disable: 
hashing/ crypt, setkey, 
generate hashing 
locations in program. 
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distance function. ..... hy pot(3M) 
distributed/ /lcong48: . . . drand48(3C) 
documents formatted with/ . mm/(1) 
documents. /the MM macro mm(5) 
documents, view graphs, - mmt(1) 
dodisk, lastlogin/ ..... acctsh(1M) 
doing what. ....-.- whodo(1M) 
double-precision number. . . strtod(3C) 
download. tdl, gtdl, . . . . tdi(1) 
drand48, erand48, ..... drand48(3C) 
drawagraph.......e- graph(1G) 
drill in number facts. - arithmetic(6) 
drive parameters for . . . . xmset(1M) 
driver, 2 2 ee eee see disk(7) 
driver, » eee eee . . « sxt(7) 
driver for tunable variables. | mktunedrv(1M) 
drivers. 2. ee eee . + drivers(7) 
drivers. 2.2 2 ee eee - Iddrv(1M) 
drivers. drvalloc, .. . . . Iddrv(2) 
drivers: loadable device . . drivers(7) 
drvalloc, drvbind: .. . . . Iddrv(2) 
drvbind: access loadable . Iddrv(2) 
drvload: system/ bre, - brce(1M) 
du: summarize disk... . du(1) 
dump: dump selected .. . dump(1) 
dump. /error records and . errdead(1M) 
dump. hd: hexadecimal . . hd(1) 
dump. 2... eee eee Od(l) 
dump selected parts of . . . dump(1) 
dup: duplicate an open . . . dup(2) 
duplicate an open file .. . dup(2) 
echo arguments. . . . . ~ « echo(1) 
echo: echo arguments. . . . echo(1) 
ecvt, fevt, gevt: 2.» + ~~ + ecvt(3C) 
ed, red: text editor. ... .- ed(1) 
edata: last locations in . . . end(3C) 
edit: text editor ...... edit(1) 
editing activity. sact: .. . sact(1) 
editor based on ex. .. ~~ vi(1) 
editor, . 2 ee eee eee ed(1) 
editor, . 2 2 6 eee ee © ex(l) 
editor for common object . . Id(1) 
editor. 2... esse cae ged(1G) 
editor output. /common . . a.out(4) 
editor, . 2.2 es - « « « sed(1) 
editor (variant of ex .. . . edit(1) 
EEPROM. .....-.- . Ideeprom(1M) 
effective group IDs. .. . . getuid(2) 
effective user, real/ . .. - getuid(2) 
eflfiles. /split ..... . fsplit(1) 
egrep, fgrep:searcha .. . grep(1) 
enable, disable: .....- enable(1) 
enable or disable ..... acct(2) 
enable/disable LP/ - enable(1) 
encrypt: generate .....- cry pt(3C) 
encryption. /encrypt: . . - crypt(3C) 
end, etext, edata: last - end(3C) 
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/getgrnam, setgrent, 
host entry. /sethostent, 
/getnetbyname, setnetent, 
socket: create an 
protocol/ /setprotoent, 
/getpwnam, setpwent, 
entry. /setservent, 
/pututline, setutent, 
Arabic numerals to 
nlist: get 

linenum: line number 
man, manprog: print 
/macros for formatting 
/manipulate line number 
a/ /seek to line number 
a/ /seek to relocation 
wtmp: utmp and wtmp 
get group file 

get network host 
endnetent: get network 
get protocol 

get password file 
endservent: get service 
access utmp file 

object file symbol table 
/index of a symbol table 
/an indexed symbol table 
write password file 
unlink: remove directory 
command execution. 
environment. 

/setting up a C shell 
profile: setting up an 
environ: user 

execution. env: set 
getenv: return value for 
change or add value to 
inteface, and terminal 
definitions for 
nroff/troff, tbl, and 
format mathematical/ 
character definitions/ 
rhosts: remote 
nrand48,/ drand48, 

td: graphical/ hpd, 
function and/ 
complementary/ erf, 
interface. 

records and status/ 
demon. 

format. 

sys_nerr:/ perror, 

erf, erfc: 

/and complementary 
/sys_nerr: system 

/to system calls and 
errdead: extract 
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endgrent, fgetgrent: get/ . 
endhostent: get network . 
endnetent: get network/ . 
endpoint for/ 
endprotoent: get ... - 
endpwent, fgetpwent: get/ 
endservent: get service .. 
endutent, utmpname:/ . . 
English. /convert 2... 
entries from name list. .. 
entries in acommon/ . » 
entries in this manual. . . 
entries in this manual. .. 
entries of acommon/ . . 
entries of asectionof .. 
entries of asectionof .. 
entry formats. utmp, .. 
entry. /fgetgrent: .... 
entry. /endhostent: ... 
entry. /setnetent, .... 
entry. /endprotoent: oO 
entry. /fgetpwent: ... 
entry. /setservent, ... 
entry. /utmpname: 
entry. /name for common 
entry of a common object / 
entry of a common object / 
entry. putpwent: 
entry. 
eny: set environment for . 
environ: user. se eo 
environment at login/ . . 
environment at login/ .. 
environment. ...« ee 
environment for command 
environment name. . . « 
environment. putenv: .. 
environment. /terminal . 
eqn and neqn. /character 

eqn constructs. /remove . 
eqn, neqn, checkeq: ... 
eqnchar: special 
equivalent users. .... 
erand48, lrand48, .... 
erase, hardcopy, tekset, . 
erf, erfc: error . 2. « « « « 
erfc: error function and. 
err: error-logging ... » 
errdead: extract error. . 
errdemon: error-logging . 
errfile: error-log file ... 
errno, sys_errlist, . ... 
error function and/ ... 
error function. ..... 
error messages. «2. + « « 
error numbers. .. «+s. 
error records and status/ . 


ee ee we ee ew 
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getgrent(3C) 
gethostent(3N) 
getnetent(3N) 
socket(2N) 
getprotoent(3N) 
getpwent(3C) 
getservent(3N) 
getut(3C) 
number(6) 
nlist(3C) 
linenum(4) 
man(1) 

man(5) 
Idlread(3X) 
Idlseek(3X) 
ldrseek(3X) 
utmp(4) 
getgrent(3C) 
gethostent(3N) 
getnetent(3N) 
getprotoent(3N) 
getpwent(3C) 
getservent(3N) 
getut(3C) 
Idgetname(3X) 
Idt bindex(3X) 
Idt bread(3X) 
putpwent(3C) 
unlink(2) 
env(1) 
environ(5} 
eprofile(4) 
profile(4) 
environ(5) 
eny(1) 
getenv(3C) 
putenv(3C) 
tset(1) 
eqnchar(5) 
deroff(1) 
eqn(1) 
eqnchar(5) 
rhosts(4N) 
drand48(3C) 
gdev(iG) 
erf(3M) 
erf(3M) 

err(7) 
errdead(1M) 
errdemon(1M) 
errfile(4) 
perror(3C) 
erf(3M) 
erf(3M) 
perror(3C) 
intro(2) 
errdead(1M) 


matherr: 

errfile: 

errdemon: 

errstop: terminate the 
err: 

a report of logged 
hashcheck: find spelling 
of logged errors. 
error-logging demon. 
terminal line/ dial: 
setmnt: 

loadable drivers. 
locations in/ end, 
disk. setenet: write 
function. hypot: 
expression. expr: 

test: condition 

/text editor (variant of 


display editor based on 
crash: 

dismount: remove 
regions of a/ locking: 
execve, execlp, execvp:/ 
execvp:/ execl, execv, 
/execy, execle, execve, 
command. path: locate 
execve, execlp, execvp: 
/argument list(s) and 
later time. at, batch: 
regex: compile and 
requests. uuxqt: 
environment for command 
sleep: suspend 

sleep: suspend 

monitor: prepare 

remote shell command 
rexecd: remote 

profil: 

to CTIX remote command 
execlp, execvp:/ execl, 
execl, execv, execle, 
/execle, execve, execlp, 
system/ link, unlink: 

a new file or rewrite an 
process. 

process. exit, 

sqrt: exponential, / 
unpack: compress and 
and/ expand, unexpand: 
tabs to spaces, and/ 
advent: 

/log, logi0, pow, sqrt: 

as an expression. 

match/ regexp: regular 
regemp: regular 

evaluate arguments as an 
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error-handling function. . 
error-log file format. .. . 
error-logging demon. . . . 
error-logging demon. .. . 
error-logging interface. . . 
errors. errpt: process .. 
errors. /spellin, .. + «+ 
errpt: process areport . . 
errstop: terminate the . . 
establish an out-going . . 
establish mount table. . . 
Iddrv: manage ..... 
etext, edata: last .... 
Ethernet address on .. 
Euclidean distance . . 2. 
evaluate arguments as an . 
evaluation command. .. 
ex for casual users). . . 
ex: text editor, ... +. 
ex. /(visual) 
examine system images. . 
exchangeable disk. . ... 
exclusive access to . 2... 
execl, execv, execle, ... 
execle, execve, execlp, . « 
execlp, execvp: execute/ . 
executable file for 
execute afile. /execle, . . 
execute command. 
execute commands ata . 
execute regular/ regemp, - 
execute remote command . 
execution. env:set ... 
execution for an/ .. +. 
execution for interval. . . 
execution profile. .... 
execution. remd: . +... 
execution server. . . « « 
execution time profile. . . 
execution. uux: CTIX .. 
execy, execle, execve, »« . « 
execve, execlp, execvp:/ . 
execyp: execute afile. . . 
exercise link and unlink . 
existing one. /create ... 
exit, _exit: terminate ... 
_exit: terminate 
exp, log, log10, pow, .. . 
expand files. /peat, .. . 
expand tabs to spaces, .. 
expand, unexpand: expand 
explore Colossal Cave. .. 
exponential, logarithm,/ . 
expr: evaluate arguments . 
expression compile and . . 
expression compile. .. . 
expression. expr: . =. « « 


oe ee 
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matherr(3M) 
errfile(4) 
errdemon(1M) 
errstop(1M) 
err(7) 
errpt(1M) 
spell(1) 
errpt(1M) 
errstop(1M) 
dial(3C) 
setmnt(1M) 
Iddrv(1M) 
end(3C) 
setenet(1INM) 
hy pot(3M) 
expr(1) 


crash(1M) 
dismount(1) 
locking(2) 
exec(2) 
exec(2) 


at(1) 
regemp(3X) 
uuxqt(1M) 
env(1) 
sleep(1) 
sleep(3C) 
monitor(3C) 
remd(1N) 
rexecd(1NM) 
profil(2) 
uux(1C) 
exec(2) 
exec(2) 
exec(2) 
link(1M) 
creat(2) 
exit(2) 


expr(1) 
regexp(5) 
regemp(1) 
expr(1) 


and execute regular 
strings in C/ xstr: 
and status/ errdead: 
strings in a/ strings: 
floor, ceil, fmod, 
factor: 


values. true, 

in a machine-independent 
fine: 

/mallopt, mallinfo: 

abort: generate an IOT 
flush a stream. 


options. 

floating-point / ecvt, 
fopen, freopen, 

stream status/ ferror, 
fileno: stream status/ 
and statistics for a/ 
stream. fclose, 

getc, getchar, 
/setgrent, endgrent, 
/setpwent, endpwent, 
a stream. gets, 

a pattern. grep, egrep, 
modification/ utime: set 
Idfen: common object 
accessibility of a 

tar: tape 

out. cpio: copy 

grpck: password /group 
chmod: change mode of 
owner and group of a 
diff: differential 

3-way differential 
fentl: 

fentl: 

rep: remote 
CTIX-to-CTIX system 
format of core image 
umask: set and get 
crontab - user crontab 
ctags: create a tags 
fields of each line of a 
using the mkfs(1) proto 
dd: convert and copy a 
(change) to an SCCS 
close: close a 

dup: duplicate an open 
type. 

hexadecimal and ascii 
parts of an object 

sact: print current SCCS 
fgetgrent: get group 
fgetpwent: get password 
utmpname: access utmp 
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expression. /compile . . 
extract and share 
extract error records . . 
extract the ASCII text . 
fabs: floor, ceiling,/ . . 
factor a number. 
factor: factor a number. 

false: provide truth .. 
fashion.. /integer data . 
fast incremental backup. 
fast main memory/ . . 
faults ose we Se 
fclose, fflush: close or . 
fentl: file control. ... 
fentl: file control .. . 
fevt, gevt: convert 
fdopen: open a stream. . 
feof, clearerr, fileno: . . 
ferror, feof, clearerr, . . 
ff: list filenames .. . 
fflush: close or flusha . 
fgetc, getw: get / 
fgetgrent: get group/ . 
fgetpwent: get password / 
fgets: get a string from . 
fgrep: search a file for . 
fileaccess and ...- 


file access routines. . 
file. access: determine 
file archiver. 
file archives in and .. 
file checkers. pwek, . - 
PIE e © eae oe ee eww et ae 
file. chown: change « « 
file comparator. 
file comparison. diff8: . 
file control. 
file control options. . . 
file copy. 
file copy. /public .. « 
file. core: «ee ewe 
file creation mask. . 
file. 
fil@s 65, rue, Ge oe ow tes 
file. /cut out selected . 
file database. /software 
file. 
file. /make adelta . . 
file descriptor. .. 
file descriptor. ... . 
file: determine file ... 
filedump. hd: 2... 
file. /dump selected . . 
file editing activity. . . 
file entry. /endgrent, . 
file entry. /endpwent, . 
file entry. /endutent, . 


oe © se ee we we 


ee © © © ee ew 


-15- 


regemp(3X) 
xstr(1) 
errdead(1M) 
strings(1) 
floor(3M) 
factor(1) 
factor(1) 
true(1) 
sputl(3X) 
finc(1M) 
malloc(3X) 
abort(3C) 
fclose(3S) 
fenti(2) 
fentl(5) 
ecvt(3C) 
fopen(3S) 
ferror(3S) 
ferror(3S) 
ff(1M) 
fclose(3S) 
getc(3S) 
getgrent(3C) 
getpwent(3C) 
gets(3S) 
grep(1) 
utime(2) 
ldfen(4) 
access(2) 
tar(1) 
epio(1) 
pwck(1M) 
chmod(2) 
chown(2) 
diff(1) 
diff3(1) 
fent](2) 
fentl(5) 
rep(1N) 
uuto(1C) 
core(4) 
umask(2) 
crontab(1) 
ctags(1) 
cut(1) 
qinstall(1) 
dd(1) 
delta(1) 
close(2) 
dup(2) 
file(1) 

hd(1) 
dump(1) 
sact(1) 
getgrent(3C) 
getpwent(3C) 
getut(3C) 


putpwent: write password 
execvp: execute a 
/egrep, fgrep: search a 
path: locate executable 
/open a common object 
Devices: configuration 
per-process accounting 
ar: common archive 
errfile: error-log 

intro: introduction to 

of a common object 

get a version of an SCCS 
group: group 

object files. filehdr: 
ldfhread: read the 

/seek to the optional 
split: split a 

issue identification 

a member of an archive 
close a common object 
of a common object 

of a common object 

of a common object 

of a common object 

of a common object 

of a common object 
entry of a common object 
entry of a common object 
table of a common object 
in a common object 
link: link to a 

file;/ glist: print out 
access to regions of a 

an ifile from an object 
mknod: build special 

or a special or ordinary 
ctermid: generate 
mktemp: make a unique 
statisties/ ff: list 

the format of a text 

list of common object 
null: the null 

/the slot in the utmp 

/ processes using a 

creat: create a new 
passwd: password 
subsequent lines of one 
soft-copy/ pg: 

/ftell: reposition a 

Iseek: move read/write 
prs: print an SCCS 
read: read from 

for a common object 

a delta from an SCCS 
bfs: big 

two versions of an SCCS 
scesfile: format of SCCS 
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fileentry. . + 2 + + + « « putpwent(3C) 
file. /execve, execlp, . . . . exec(2) 

file for a pattern. .... . grep(1) 

file for command. ..... path(1) 

file for reading. ...... Idopen(3X) 
file for uucp/ . ... .. « Devices(5) 
file format. acct: . 2. acct(4) 
fileformat. .. 2... ar(4) 
fileformat. . 2... - errfile(4) 
fileformats. . .... 2. intro(4) 

file function. /entries . . . Idlread(3X) 
file. get: . 2. 2 ee eo = get(l) 

files * ei oie; safes we eee. group(4) 
file header for common . . . filehdr(4) 
file header of acommon/ . . Idfhread(3X} 


file header of a common/ 


- Idohseek(3X) 


file into pieces. .. 2... split(1) 

file. issue: ..... +. issue(4) 

file. /archive header of . Idahread(3X) 
file. /Idaclose: . 2... Idclose(3X) 
file. /the file header . . . . Idfhread(3X) 
file. /ofasection ..... Idlseek(3X) 
file. /fileheader ..... Idohseek(3X) 
file. /ofasection ....- idrseek(3X) 
file. /section header . . . . Idshread(3X) 
file. /section . .. . + © « Idsseek(3X) 
file. /ofasymbol table . . Idtbindex(3X) 
file. /symbol table .. . . Idtbread(3X) 
file. /tothe symbol .. . © Idtbseek(3X) 
file. /number entries .. . linenum(4) 
file. 2. 6 2. ee ee © link(2) 

file lists from proto... . qlist(1) 

file. /exclusive ... . . + locking(2) 
file. mkifile: make . . . . . mkifile(1M) 
file. 6 6 . 2 «© «© «© © » « « mknod(1M) 
file. /make a directory, mknod(2) 
file name for terminal. etermid(3S) 
filename. 2. eee eee mktemp(3C) 
filenamesand ..... . ff(1M) 

file. newform: change .. . newform(1) 
file. nm: print name . .. . nm(1) 

file. «eee ene evee null(7) 

file of the current/ ... . ttyslot(3C) 
file or file structure. . . . . fuser(1M) 
file or rewrite an/ .. . . « creat(2) 
file. 2... 2.2 + «+ © « © passwd(4) 
file. /several filesor . .. . paste(1) 

file perusal filter for . . . . pg(1) 

file pointer ina/ .. +... fseek(3S) 

file pointer. . 2 2 2 ee ee Iseek(2) 

file. 2 2 6 0 ee we oe © © prs(l) 

files. faiietas Sie os 6 « © read(2) 

file. /information ..... reloc(4) 

file. rmdel: remove .. . . rmdel(1) 
filescanner. . 2. eee bfs(1) 

file. scesdiff: compare . . . sccsdiff(1) 
PUG. erie eee Se scesfile(4) 
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for a common object 
/file lists from proto 
fsize: report 

i-node. openi: open a 
stat, fstat: get 

ASCII text strings in a 
from a common object 
/using a file or 

and block count of a 
synchronous write on a 
/name for common object 
syms: common object 
check and/ fsck, dfsck: 
fsdb: 

and statistics for a 

fs: 

mkfs: construct a 
mount and dismount 
mount: mount a 

ustat: get 

mnttab: mounted 
umount: unmount a 
system description 
access/ dcopy: copy 
by/ checklist: list of 
volcopy, labelit: copy 
the last part of a 
format of compiled term 
create a temporary 

a name for a temporary 
modification times of a 
ftp: 

ftpd: DARPA Internet 
tftpd: DARPA Trivial 
ftw: walk a 

file: determine 

TZ: time zone 

previous get of an SCCS 
repeated lines in a 

and Permissions 

val: validate SCCS 
write: write on a 
umask: set 

common object files. 
ferror, feof, clearerr, 
print process accounting 
or add total accounting 
and administer SCCS 
concatenate and print 
emp: compare two 
common to two sorted 
mv: copy, link or move 
mark differences between 
header for common object 
find: find 

catman: create the cat 
tape. frec: recover 
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file. /section header . . . . senhdr(4) 
file; set links based/ . . . - qlist(1) 
filesize, . 6... ee ee @ fsize(l) 
file specified by ... . - + openi(2) 
file status. . 2... «+. + stat(2) 
file. /extract the .. . . . strings(1) 
file. /information .. . . « strip(1) 
file structure. . . . . +. + fuser(1M) 
file. /print checksum - sum(1) 
file. swrite: . 2. + » © « « swrite(2) 
file symbol table entry. . . . Idgetname(3X) 
file symbol table/ ... . » syms(4) 
file system consistency - fsck(1M) 
file system debugger. . . . fsdb(1M) 
file system. /file names » {f(1M) 
file system format. - fs(4) 
filesystem. . .... » ~~ mkfs(1M) 
file system. /umount: + mount(1M) 
filesystem. . .... +.» mount(2) 
file system statistics. . . . . ustat(2) 
filesystem table. ....- mnttab(4) 


filesystem. . 2. 2 2 2 ee 
file. system: . 2. 6 2 e 


. umount(2) 
. system(4) 


file systems for optimal « dcopy(1M) 
file systems processed . . . checklist(4) 
file systems with label/ . . volcopy(1M) 
file. tail: deliver... - © « tail(1) 

file. term: ....... © term(4) 
file. tmpfile. . ... . . - tmpfile(3S) 
file. /tempnam: create . . . tmpnam(3S) 
file. /update access and . . touch(1) 
file transfer program. .. . ftp(1N) 
File Transfer Protocol/ . . ftpd(i1NM) 
File Transfer Protocol/ . . tftpd(1NM) 
filetree, 2 2 2 2 ee eo & ftw(3C) 
filetype. . 2... 2. file(1) 

Ble, cahephi caste 2d del soc ps AEA) 

file. unget: undoa ... « unget(1) 
file. unig: report... . . uniq(t) 

file. /UUCP directories . . uucheck(1M) 
file. 2.2 cee ewes - val(1) 

file. 2. 2 eee ee eee « write(2) 
filecreation mode mask. . . umask(1) 
filehdr: file header for » filehdr(4) 
fileno: stream status/  . . . ferror(3S) 
file(s). /search and .. . . acctcom(1) 
files. acctmerg: merge » acctmerg(1M) 
files. admin: create . admin(1) 
files. cat: 2. 2-2 eee » cat(l) 

files, 06 668 8 ee ae - emp(1) 
files. /or reject lines . . . « comm(1) 
files. cp, In, . 2+ «+. « cep(l) 

files. diffmk: .... .. . diffmk(1) 
files. filehdr: file .....- filehdr(4) 
files. «5 6 2 6 ee ee © find(l) 
files for the manual. . .. . catman(1) 
files from a backup .. © - frec(1M) 
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specification in text 
ratfor, or efl 

format of graphical 
epset: install object 
preprocessor include 
introduction to special 
editor for common object 
lockf: record locking on 
rm, rmdir: remove 
/same lines of several 
compress and expand 
pr: print 

sizes of common object 
sort: sort and/or merge 
/object and archive 
what: identify SCCS 
pg: file perusal 

greek: select terminal 
nl: line numbering 
line-feeds. col: 

device routines and 
tplot: graphics 

backup. 

find: 


hyphen: 

ttyname, isatty: 

for an object/ lorder: 
/spellin, hashcheck: 
utmp file of/ ttyslot: 
/fold long lines for 
fish: play ‘‘Go 


tee: pipe 

/convert ASCII string to 
/fevt, gevt: convert 
/manipulate parts of 
floor, ceiling,/ 

floor, ceil, fmod, fabs: 
cflow: generate C 

felose, fflush: close or 
ceiling,/ floor, ceil, 

for finite width output/ 
finite width/ fold: 
open a stream. 

process. 

accounting file 

ar: common archive file 
errfile: error-log file 

fs: file system 

for/ eqn, neqn, checkeg: 
newform: change the 


inode: 

file.. term: 
file. core: 
cpio: 

dir: 
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files. fspec: format 
files. /split FORTRAN, 


files. /string, . 2... 


fspec(4) 
fsplit(1) 
gps(4) 


files in binary/ ... . . . cpset(1M) 
files. /C language ... . . includes(1) 
files. intro: » . 6. 6 « » « intro(7) 
files. ld: link . 2... +. Id(1) 
files, . 2 6 ee ee 6 eo © «© lockf(3C) 
files or directories. . . . « . rm(1) 
files or subsequent/ .. . . paste(1) 
files. /pcat, unpack: . . . . pack(1) 
filesi se ere aah » pr(1) 
files. /print section .. . . size(1) 
files, . 2 6 ee we ee © Sort(l) 
files to common formats. . . convert(1) 
files, 2 2 ee ee ee ee © What(l) 
filter for soft-copy/ - + pe(l) 
filter, . 2 2 2 ee ee «© greek(1) 
filter, 2 6 6 2 ee ew ee ~ oll) 
filter reverse . 2. 2 6 « «© col(1) 
filters. /td: graphical - . gdev(1G) 
filters. 2 2 2 2 6 ee © «© tplot(1G) 
fine: fast incremental » . fine(1M) 
find files. » .. +... +. find(1) 
find: find files. .... .. find(1) 
find hyphenated words. .. hyphen(1) 
find name of aterminal. . . ttyname(3C) 
find ordering relation . . . lorder(1) 
find spelling errors. . . . . spell(1) 
find the slotinthe .. . . ttyslot(3C) 
finite width output/ . . . . fold(1) 
Fish”. 2 6 se eee eae Sonal 
fish: play “‘Go Fish”. . .. fish(6 
fitting, . 2 2 ee ee ws tee(l) 
floating-point number. . . . atof(3C) 
floating-point number to/ . ecyt(3C) 
floating-point numbers. . . frexp(3C) 
floor, ceil, fmod, fabs: + + floor(3M) 
floor, ceiling,/ . . . + + + « floor(3M) 
flowgraph. .« . 2 ++ + cflow(1) 
flush a stream. ... +. « fclose(3S) 
fmod, fabs: floor, .. +. . floor(3M) 
fold: fold long lines « + + fold(1) 
fold long lines for... . © fold(1) 
fopen, freopen, fdopen: . . . fopen(3S) 
fork: createa new .... . fork(2) 
format. /per-process - + acct(4) 
format. 6 +. 66 2 + + ar(4) 
format. . 6. ee + + 6 © errfile(4) 
format. . 2.6.2 «. fs(4) 
format mathematical text . eqn(1) 
format of a text file. . . . . newform(1) 
format of an i-node. . . . . inode(4) 
format of compiled term . . term(4) 
format of core image . . . . core(4) 
format of cpio archive. - cpio(4) 
format of directories. . . . dir(4) 
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/primitive string, format of graphical/ . . . . gps(4) 
scesfile: format of SCCS file. . . . . sccsfile(4} 
text files. fspec: format specification in . . . fspec(4)} 
object file symbol table format. syms: common  . . syms(4) 
or troff. tbl: format tables for nroff . . . tbi(1) 
nroff: format text. .. 2s ees nroff(1) 
archive files to common formats. /objectand .. . convert(1) 
introduction to file formats. intro: ... . . . intro(4) 
utmp and wtmp entry formats. utmp, wtmp: .. . utmp(4) 
fscanf, sscanf: convert formatted input. scanf, . . scanf(3S) 
varargs/ /vsprintf: print formatted output ofa . . . vprintf(3S) 
/fprintf, sprintf: print formatted output. ..... printf(3S) 
/print/check documents formatted with the MM/ . . mm(1) 
/the macro package for formatting a permuted/ . . mptx(5) 
/the MM macro package for formatting documents. . . . mm(5) 
this/ man: macros for formatting entriesin . . . . man(5) 
management. netman: form-based network .. . . netman(1NM) 
efl/ fsplit: split FORTRAN, ratfor, or . . . fsplit(1) 
hopefully interesting,/ fortune: print a random, . . fortune(6) 
formatted/ printf, fprintf, sprintf: print . . . . printf(3S) 
pute, putchar, fputc, putw: put/ ..... pute(3S) 
stream. puts, fputs: putastringona . . puts(3S) 
input/output. fread, fwrite: binary .. . . fread(3S) 
a backup tape. frec: recover files from . . . frec(1M) 
df: report number of free disk blocks. . . . . ~~ df(1M) 


main memory/ malloc, free, realloc, calloc: . . . + malloc(3C) 
mallopt,/ malloc, free, realloc, calloc, . . . . malloc(3X) 
stream. fopen, freopen,fdopen: opena . . fopen(3S) 
manipulate parts of/ frexp, ldexp, modf: .. . . frexp(3C} 
frec: recover files froma backup tape. . . . . frec(1M) 
/line number information from acommon object/ . . strip(1) 
/receive a message fromasocket. ... ~~ © recv(2N) 
get character or word from astream. /getw: . . . getc(3S) 
fgets: get a string fromastream. gets, . .. . gets(3S) 
mkifile: make an ifile from an object file. . . . . mkifile(1M) 
rmdel: remove a delta from an SCCS file. . . . . rmdel(i) 
/get option letter from argument vector. - » getopt(3C) 


and status information from dump. /records .. . errdead(1M) 


read: read from file. . 2... 2 2 eee read(2) 
ncheck: generate names from i-numbers. ... +. - ncheck(1M) 
nlist: get entries from name list. ..... - nlist(3C) 
DARPA Internet address from node name. /set .. . setaddr(1NM) 
acctems: command summary from per-process/ .. +.» acctems(1M) 
/print out file lists from proto file; set/ . . . . qlist(1) 
getpw: get name from UID. ........ getpw(3C) 


fs: file system format. .. . fs(4) 
formatted input. scanf, fscanf, sscanf: convert . . . scanf(3S) 
systems processed by fsck. /list of file ..... checklist(4) 
make a lost+found directory for fsck. . . «+ 6 ¢ « + + + « mklost+found(1M) 
consistency check and/ fsck, dfsck: file system . . . fsck(1M) 
debugger. fsdb: filesystem .... . . fsdb(1M) 
reposition a file/ fseek, rewind, ftell: . . . . fseek(3S) 
fsize: report file size. . . . . fsize(1) 
specification in text/ fspec: format .... +. © fspec(4) 
ratfor, or efl files. fsplit: split FORTRAN, . . fsplit(1) 
stat, fstat: get file status. . . . . stat(2) 
pointer/ fseek, rewind, ftell: reposition a file . . . . fseek(3S) 
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interprocess/ 
program. 
File Transfer Protocol/ 


/shut down part of a 
erf, erfc: error 

and complementary error 
gamma: log gamma 
Euclidean distance 

of a common object file 
matherr: error-handling 
prof: profile within a 
math: math 

jn, yO, yl, yn: Bessel 
power, square root 
absolute value 

ocurse: optimized screen 
/300s: handle special 
hp: handle special 

450/ 450: handle special 
cosh, tanh: hyperbolic 
atan2: trigonometric 
processes using a file/ 
input/output. fread, 
manipulate connect / 
moo: guessing 

back: the 

bj: the 

craps: the 

wump: the 

trk: trekkie 

intro: introduction to 
gamma: log 

function. 

ecvt, fcvt, 


maze: 
abort: 

cflow: 

cross-reference. cxref: 
data by user/ diskusg: 
terminal. ctermid: 
crypt, setkey, encrypt: 
i-numbers. ncheck: 
simple lexical/ lex: 
/seed48, lcong48: 
simple random-number 
stream. gets, fgets: 
file. get: 

getsockopt, setsockopt: 
ulimit: 

of the user. cuserid: 
/getchar, fgetc, getw: 
list. nlist: 

umask: set and 

stat, fstat: 

statistics. ustat: 
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ftok: standard ..... 
ftp: file transfer ..... 
ftpd: DARPA Internet .. 
ftw: walk a file tree. . 2. 
full-duplex connection. .. 
function and/ ...... 
function. /function ... 
function. 
function. hypot: .... 
function. /entries .... 
function. 
function. 
functions and constants. . 
functions. j0,jl, .... 
functions. /logarithm, . . 
functions. /remainder, . . 
functions. 


eee ee eee 


functions of DAS] 300/ . . 


functions of HP 2640 and/ 
functions of the DASI . . 
functions. sinh, 
functions. /acos, atan, . . 
fuser: identify ...... 
fwrite: binary 
fwtmp, wtmpfix: .... 
game. . 
game of backgammon. . . 
game of black jack. ... 
game of craps. 
game of hunt-the-wumpus. 
game. 
games. 
gamma function. .... 
gamma: log gamma ... 
gevt: convert/ 
ged: graphical editor. .. 
generate a maze. . 2. « 
generate an JOT fault. .. 
generate C flowgraph. .. 
generate C program ... 
generate disk accounting . 
generate file name for .. 
generate hashing/ 
generate names from .. .- 
generate programs for .. 
generate uniformly/ ... 
generator. rand, srand: . 
get astringfroma ... 
get a version of anSCCS . 
get and set options on/_ . 
get and set user limits. . . 
get character login name . 
get character or word/ .. 
get entries from name .. 
get file creation mask. .. 
get file status. 
get file system 


ee e@ ee 


ee ee © 
oe © © we we we 
ee e we © 
oe eo we we we ew we 


ee © © © ee © 


oe © we 
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stdipc(3C) 
ftp(1N) 
ftpd(1NM) 
ftw(3C) 
shutdown(2N) 
erf(3M) 
erf(3M) 
gamma(3M) 
hy pot(3M) 
Idlread(3X) 
matherr(3M) 
prof(5) 
math(5) 
bessel(3M) 
exp(3M) 
floor(3M) 
ocurse(3X) 
300(1) 

hp(i) 

450(1) 
sinh(3M) 
trig(3M) 
fuser(1M) 
fread(3S) 
fwtmp(1M) 


maze(6) 
abort(3C) 
cflow(1) 
exref(1) 
diskusg(1M) 
ctermid(3S) 
cry pt(3C) 
ncheck(1M) 
lex(1) 
drand48(3C) 
rand(3C) 
gets(3S) 
get(1) 
getsockopt(2N) 
ulimit(2) 
cuserid(3S) 
getc(3S) 
nlist(3C) 
umask (2) 


. stat(2) 


ustat(2) 


SCCS file. 

/endgrent, fgetgrent: 
getlogin: 

logname: 

msgget: 

getpw: 

peer. getpeername: 
system. uname: 

host. gethostname: 
/setnetent, endnetent: 
/sethostent, endhostent: 
unget: undo a previous 
argument/ getopt: 
/endpwent, fgetpwent: 
working/ getcwd: 
process times. times: 
/getperp, getppid: 
/endprotoent: 

user,/ /getgid, getegid: 
/setservent, endservent: 
semget: 

segment. shmget: 
getsockname: 

terminal. tty: 

time: 

getw: get character or/ 
get character or/ getc, 
current working/ 
getuid, geteuid, getgid, 
environment name. 
getegid: get/ getuid, 
real/ getuid, geteuid, 
getgrnam, setgrent,/ 
setgrent,/ getgrent, 
getgrent, getgrgid, 
gethostent, 
/gethostbyaddr, 
gethostbyaddr,/ 
current host. 

name. 

getnetent, 

getnetent, getnetbyaddr, 
getnetbyname, / 

letter from argument / 
options. 

password. 

connected peer. 
process,/ getpid, 
getppid: get process, / 
getpid, getpgrp, 
/getprotobynumber, 
getprotoent, 
getprotobynumber,/ 
UD. 

getpwnam, setpwent,/ 
getpwent, getpwuid, 
setpwent,/ getpwent, 
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get: get a version of an . 
get group file entry. .. 
get login name. .... 
get login name. ...-. 
get message queue. .. 
get name from UID. .. 
get name of connected . 
get name of current CTIX 
get name of current .. 
get network entry. . .. 
get network host entry. 
get of an SCCS file. . . 
get option letter from . 
get password file entry. 
get path-name of current 
get process and child. 
get process, process/ . . 
get protocol entry. ... 
get real user, effective . 
get service entry. ... 
get set of semaphores. . 
get shared memory. . 
get socket name. ... 
get the name ofthe .. 
get time. 
getc, getchar, fgetc, .. 
getchar, fgetc, getw: . . 
getcwd: get path-name of 
getegid: get real user,/ . 
getenv: return value for 
geteuid, getgid, 
getgid, getegid: get .. 
getgrent, getergid, ... 
getgrgid, getgrnam, .. 
getgrnam, setgrent,/ .. 
gethostbyaddr,/ .... 
gethostbyname,/ ... 
gethostent, ....-- 
gethostname: get name of 
getlogin: get login 
getnetbyaddr,/ 
getnetbyname, setnetent,/ 
getnetent, getnetbyaddr, 
getopt: get option 
getopt: parse command 
getpass: read a 
getpeername: get name of 
getperp, getppid: get. 
getpid, getpgrp, 
getppid: get process,/ . 
getprotobyname,/ ... 
getprotobynumber,/ .. 
getprotoent, 
getpw: get name from . 
getpwent, getpwuid, .. 
getpwnam, setpwent,/ . 
getpwuid, getpwnam, . 


eee eo we ew 
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get(1) 
getgrent(3C) 
getlogin(3C) 
logname(1) 
msgget (2) 
getpw(3C) 
getpeername(2N) 
uname(2) 
gethostname(3N) 
getnetent(3N) 
gethostent(3N) 
unget(1) 
getopt(3C) 
getpwent(3C) 
getcwd(3C) 
times(2) 
getpid(2) 
getprotoent(3N) 
getuid(2) 
getservent(3N) 
semget(2) 
shmget(2) 
getsockname(2N) 
tty(1) 

time(2) 

getc(3S) 
getc(3S) 
getcwd(3C) 
getuid(2) 
getenv(3C) 
getuid(2) 
getuid(2) 
getgrent(3C) 
getgrent(3C) 
getgrent(3C) 
gethostent(3N) 
gethostent(3N) 
gethostent(3N) 
gethostname(3N) 
getlogin(3C) 
getnetent(3N) 
getnetent(3N) 
getnetent(3N) 
getopt(3C) 
getopt(1) 
getpass(3C) 
getpeername(2N) 
getpid(2) 
getpid(2) 
getpid(2) 
getprotoent(3N) 
getprotoent(3N) 
getprotoent(3N) 
getpw(3C) 
getpwent(3C) 
getpwent(3C) 
getpwent(3C) 


string from a stream. 
/getservbyport, 
getservent, 
getservbyport,/ 

name. 

get and set options on/ 
settings used by 

type, modes, speed, and/ 
terminal. ct: spawn 
terminal settings used/ 
getegid: get real user,/ 
getutline, pututline,/ 
pututline,/ getutent, 
getutent, getutid, 

getc, getchar, fgete, 
ctime, localtime, 

fish: play 

longjmp: non-local 
string, format of/ 


graph: draw a 

sag: system activity 
graphics: access 
/network useful with 
hardcopy, tekset, td: 
ged: 

/string, format of 
string, format of/ gps: 
contents routines. toc: 
gutil: 

graphical and numerical/ 
tplot: 

plot: 

subroutines. plot: 
/typeset documents, view 
/for typesetting view 
filter. 

search a file for a/ 
/effective user, real 

/get process, process 
chgrp: change owner or 
/endgrent, fgetgrent: get 
group: 


setpgrp: set process 

id: print user and 
group, and effective 
setgid: set user and 
newegrp: log in to a new 
chown: change owner and 
signal to a process or a 
/update, and regenerate 
file checkers. pwck, 
signals. ssignal, 

/or relocate a PT or 
terminal download. tdl, 
hangman: 
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gets, fgets: gta... . 
getservbyname,/ ... 
getservbyport,/ 
getservent, 
getsockname: get socket 

getsockopt, setsockopt: . 
getty. /andterminal . 
getty: set terminal . .. 
getty toaremote ... 
gettydefs: speed and .. 
getuid, geteuid, getgid, . 
getutent, getutid, ... 
getutid, getutline, ... 
getutline, pututline,/ . 
getw: get character or/ . 
gmtime, asctime, tzset:/ 

“Go Fish”. 2... 6 
goto. setjmp, 
gps: graphical primitive 

graph: draw agraph. . 
graph. 
graph. 
graphical and numerical/ 
graphical commands. . 
graphical device/ /erase, 
graphical editor. 
graphical files. .... 
graphical primitive .. 
graphical tableof ... 
graphical utilities. . . . 
graphics: access . 1... 
graphics filters. . .. 
graphics interface. . .. 
graphics interface .. . 
graphs, and slides. . . . 
graphs and slides. 2... 
greek: select terminal . 
grep, egrep, fgrep: . 
group, and effective/ . 
group, and parent/ .. 
group. chown, .... 
group fileentry. .... 
group file. 
group: group file. ... 
group ID. 
group IDs and names. . 
group IDs. /user, real . 
group IDs. setuid, ... 
group. 
group of a file. 
group of processes. /a . 
groups of programs. .. 
grpck: pero tiene ‘ 
gsignal: software ... 
GT local printer. ... 
gtdl, ptdl: RS-232 ... 
guess the word. .... 


oe ee 
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gets(3S) 
getservent(3N) 
getservent(3N) 
getservent(3N) 
getsockname(2N) 
getsockopt(2N) 
getty defs(4) 
getty(1M) 

et(1C) 
gettydefs(4) 
getuid(2) 
getut(3C) 
getut(3C) 
getut(3C) 
getc(3S) 
ctime(3C) 
fish(6) 
setjmp(3C) 
gps(4) 
graph(1G) 
graph(1G) 
sag(1G) 
graphics(1G) 


. stat(1G) 


gdev(1G) 
ged(1G) 
gps(4) 
gps(4) 
toc(1G) 
gutil(1G) 
graphics(1G) 
tplot(1G) 
plot(4) 
plot(3X) 
mmit(1) 
mv(5) 
greek(1) 
grep(1) 
getuid(2) 
getpid(2) 
chown(1) 
getgrent(3C) 
group(4) 
group(4) 
setpgrp(2) 
id(1) 
getuid(2) 
setuid(2) 
newgrp(1) 
chown(2) 
kill(2) 
make(1) 
pwek(1M) 
ssignal(3C) 
mktpy(1) 
tdl(1) 
hangman(6) 


2 
2 
1 


moo: 
utilities. 

/for Xylogics 772 
processing. shutdown, 
of DASI 300/ 300, 300s: 
of HP 2640 and/ hp: 

of the DASI 450/ 450: 
list. varargs: 

curses: CRT screen 


/run a command immune to 
graphical/ hpd, erase, 
hinv: 

/hdestroy: manage 
/hashmake, spellin, 
/encrypt: generate 
hashcheck: find/ spell, 
manage hash/ hsearch, 
ascii file dump. 
hsearch, hcreate, 
object/ senhdr: section 
files. filehdr: file 
Idfhread: read the file 
to the optional file 
indexed/named section 
/read the archive 


help: ask for 

file dump. hd: 
inventory. 

{manipulate Volume 
fortune: print a random, 
/convert values between 
endhostent: get network 
get name of current 
network. 

/special functions of 
functions of HP 2640/ 
tekset, td: graphical/ 
hdestroy: manage hash/ 
ntohs: convert values/ 
convert values/ htonl, 
wump: the game of 
sinh, cosh, tanh: 

words. 

hyphen: find 

distance function. 
accounting data by user 
set or shared memory 
IDs and names. 

set process group 

issue: issue 

a file or file/ fuser: 
what: 

id: print user and group 
and parent process 

and effective group 
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guessing game. .....- > 


moo(6) 


gutil: graphical . . ~~... gutil(1G) 
half-inch tape/ ... . »- « xmset(1M) 
halt: terminate all . . . . . shutdown(1M) 
handle special functions . . 300(1) 

handle special functions . . hp(1) 

handle special functions . 450(1) 


handle variable argument 
handling and/ «2... 
hangman: guess the word. 


hangups and quits. .. . . nohup(1) 
hardcopy, tekset, td: . . . . gdev(1G) 
hardware inventory. . . . » hinv(1M) 
hash search tables. .. . . hsearch(3C) 
hashcheck: find spelling/ . . spell(1) 
hashing encryption. ... ~ erypt(3C) 
hashmake, spellin, . . . - . spell(1) 
hcreate, hdestroy: ... . . hsearch(3C) 
hd: hexadecimal and . .. . hd(1) 
hdestroy: manage hash/ - hsearch(3C) 
header foracommon’ . .. - scnhdr(4) 
header for common object . filehdr(4) 
header of acommon/ .. . Idfhread(3X) 
header of acommon/ /seek Idohseek(3X) 
header of acommon/ /an_ . Idshread(3X) 
header of a member of an/ . Idahread(3X) 
help: ask for help. . ~~ - ~ help(1) 

help. . » «© ee © ew © © © help(l) 
hexadecimal and ascii... hd(1) 

hinv: hardware... . ~~ hinv(1M) 
Home Blocks (VHB). . . - - libdev(3X) 
hopefully interesting,/ . . . fortune(6) 
host and network byte/ . . byteorder(3N) 
host entry. /sethostent, . . gethostent(3N) 
host. gethostname: .. . . gethostname(3N) 
hosts: list of nodeson . . ~ hosts(4N) 
HP 2640 and 262I-series/ . hp(1) 

hp: handle special . . . . - hp(1) 

hpd, erase, hardcopy, .. - gdev(1G) 
hsearch, hcreate, ....- hsearch(3C) 
htonl, htons, ntohl, .. + - byteorder(3N) 
htons, ntohl, ntohs: . . . . byteorder(3N) 
hunt-the-wumpus. ..... wump(6) 
hyperbolic functions. . .. . sinh(3M) 
hyphen: find hyphenated . . hyphen(1) 
hyphenated words. ... . hyphen(1) 
hypot: Euclidean... e- hy pot(3M) 


ID. generate disk .... 


- varargs(5) 
- curses(3X) 
- hangman(6) 


» diskusg(1M) 


id. /queue, semaphore - iperm(1) 
id: print user and group - id(1) 

ID. setpgrp: . +... « setpgrp(2) 
identification file. . .. +. issue(4) 


identify processes using 
identify SCCS files. 

IDs and names. 
IDs. /process group, » + «+ + 
IDs. /user, real group, 


a OSs 


- fuser(1M) 
- what(1) 


id(1) 
getpid(2) 


- getuid(2) 


set user and group 
network interface/ 

file. mkifile: make an 
core: format of core 
crash: examine system 
nohup: run a command 
/C language preprocessor 
language preprocessor / 
fine: fast 

/tgoto, tputs: terminal 
formatting a permuted 
Idtbindex: compute the 
ptx: permuted 

entry/ Idtbread: read an 
/\dnshread: read an 

of/ /ldnsseek: seek to an 
inet_ntoa,/ 

Internet/ /inet_makeaddr, 
/inet_network, inet_ntoa, 
address/ /inet_Inaof, 
inet_addr, 

inet_addr, inet_network, 
inittab: script for the 
control initialization. 
telinit: process control 
/drvload: system 
volume. iv: 

a socket. connect: 
process. popen, pclose: 
init process. 

clri: clear 

i-node. 

inode: format of an 
open a file specified by 
blocks associated with 
/start and stop terminal 
convert formatted 

push character back into 
fread, fwrite: binary 
stdio: standard buffered 
fileno: stream status 
uustat: uucp status 
software/ qinstall: 
install: 

commands. 

binary/ cpset: 

or GT/ mktpy, mvtpy: 
ctinstall: 

/set. terminal, terminal 
abs: return 

/convert between long 
/seetl: access long 

atoi: convert string to 
/convert between 3-byte 
3-byte integers and long 
beopy: 

processing/ mailx: 
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IDs. setuid, setgid: .. 
ifconfig: configure ... 
ifile from an object .. 
image file. 
images. 

immune to hangups and/ 
include files. ..... 
includes: determine C  . 
incremental backup. 
independent operations. 
index. /package for 
index of a symbol table/ 
index. 2 «eee eee 
indexed symbol table . 
indexed /named section/ 
indexed/named section . 
inet_addr, inet_network, 
inet_lnaof, inet_netof: . 
inet_makeaddr,/ .. . 
inet_netof: Internet 
inet_network, inet_ntoa,/ 
inet_ntoa,/ 2... ee 
init process. 
init, telinit: process . . 
initialization. init, . . . 
initialization shell/ . . 
initialize and maintain . 
initiate a connection on 

initiate pipe to/froma . 
inittab: script forthe . 
i-node. . 
inode: format ofan .. 
i-node. . 
i-node. openi: . . 2. « « 
i-node(s). /the list of . 
input and output. 
input. /fscanf, sscanf: . 
input stream. ungetec: . 
input/output. ..... 
input/output package. . 
inquiries. /clearerr, . . 
inquiry and job control. 

install and verify 
install commands. 
install: install . 2... 
install object files in . . 
install or relocatea PT . 
install software. 
inteface, and terminal/ . 
integer absolute value. . 
integer and base-64/ . . 
integer dataina/ ... 
integer. strtol, atol, . . 
integers and long/ .. . 
integers. /between . . 
interactive block copy. . 
interactive message . . 


ee eo ® 


ee © ew ew 


ee ee we ew ew 


oe e 
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setuid(2) 
ifconfig(1NM) 
mkifile(1M) 
core(4) 
crash(1M) 
nohup(1) 


. ineludes(1) 


includes(1) 
finc(1M) 
termcap(3X) 
mptx(5) 
Idtbindex(3X) 
ptx(1) 
Idtbread(3X) 
Idshread(3X) 
Idsseek(3X) 
inet(3N) 
inet(3N) 
inet(3N) 
inet(3N 
inet(3N 
inet(3N) 
inittab(4) 

) 


iv(1) 
connect(2N) 
popen(3S) 
inittab(4) 
clri(1M) 
inode(4) 
inode(4) 
openi(2) 
bcheck(1M) 
rsterm(1M) 
scanf(3S) 
ungetc(3S) 
fread(3S) 
stdio(3S) 
ferror(3S) 
uustat(1C) 
qinstall(1) 
install(1M) 
install(1M) 
cpset(1M) 
mktpy(1) 
ctinstall(1) 
tset(1) 
abs(3C) 
2641(3C) 
sputl(3X) 
strtol(3C) 
I3tol(3C) 
13tol(3C) 
beopy(1M) 
mailx(1) 


/consistency check and 

/a random, hopefully 

err: error-logging 

qic: 

Ip: parallel printer 

mem, kmem: system memory 
/configure network 

plot: graphics 

plot: graphics 

swap administrative 

termio: general terminal 
terminal accelerator 
protocol. telnet: user 
TFTP/ tftp: user 
controlling terminal 

yme: VME bus 

serial lines as network 

node/ setaddr: set DARPA 
/inet_Inaof, inet_netof: 
Protocol/ ftpd: DARPA 
and numbers for the 
protocols: list of 

services: list of 

curve. spline: 

control/ asa: 

csh: a shell (command 

pipe: create an 

ipes: report 

ftok: standard 

suspend execution for an 
suspend execution for 
commands and/ 

file formats. 

games. 

miscellany. 

special files. 

subroutines and/ 

system calls and error/ 

and application/ intro: 
formats. intro: 

intro: 
intro: 
intro: 
subroutines and/ intro: 
calls and error/ intro: 
generate names from 
hinv: hardware 


miscellany. 
files. 


abort: generate an 
queue, semaphore set or/ 
inter-process/ 

/isdigit, isxdigit, 

islower, isdigit,/ 
/isgraph, isentr], 
terminal. ttyname, 
/isprint, isgraph, 
Jisupper, islower, 
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interactive repair. . . . 
interesting, adage. . . » - 
interface. 
interface for QIC tape. . . 
interface. 
interface. 
interface parameters. .. 
interface. .. 2... 2 ee 
interface subroutines. . . 
interface. swap: . 2. . + « 
interface. . 2. 2. ee eee 
interface. tiop: . 2... 
interface to TELNET .. 
interface tothe DARPA . 
interface. tty: .. 2... 
interface. . 2. 2. 2 ee ee 
interfaces. /anddetach . 
Internet address from .. 
Internet address/ ...- 
Internet File Transfer .. 
internet. /names .. 
Internet protocols. . . . . 
Internet services. ... 
interpolate smooth ... 
interpret ASA carriage . . 
interpreter) with C-like/ . 
interprocess channel. . . . 
inter-process/ . . . 6 « 
interprocess/ . ee ee 
interval. sleep: ... +. 
interval. sleep: ... + 
intro: introduction to . . 
intro: introduction to .. 
intro: introduction to .. 
intro: introduction to .. 
intro: introduction to .. 
intro: introduction to .. 
intro: introduction to .. 
introduction to commands 
introduction to file ... 
introduction to games. . . 
introduction to 
introduction to special . . 
introduction to 
introduction to system .. 
i-numbers. ncheck: ... 
inventory. 
ioctl: control device. . . - 
JOT faults? acces ede ss 
iperm: remove a message .- 
ipes: report 
isalnum, isspace,/ ... » 
isalpha, isupper, » .. + - 
isascii: classify/ ...-+- 
isatty: find name ofa .. 
isentrl, isascii:/ .. . + » 
isdigit, isxdigit,/ .... 
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fsck(1M) 
fortune(6) 


. mem(7) 


ifconfig(1NM) 
plot(4) 
plot(3X) 
swap(1M) 
termio(7) 
tiop(7) 
telnet(1N) 
tftp(1N) 
tty(7) 

vme(7) 
slattach(1NM) 
setaddr(1NM) 
inet(3N) 
ftpd(1NM) 
networks(4N) 
protocols(4N) 
services(4N) 
spline(1G) 
asa(1) 

esh(1) 

pipe(2) 
ipes(1) 
stdipe(3C) 
sleep(1) 


ncheck(1M) 
hinv(1M) 
ioctl(2) 
abort(3C) 
iperm(1) 
ipes(1) 
etype(3C) 
ety pe(3C) 
ety pe(3C) 
ttyname(3C) 
ety pe(3C) 
ety pe(3C) 


/ispunct, isprint, 
isalpha, isupper, 
/isspace, ispunct, 
/isalnum, isspace, 
/isxdigit, isalnum, 
system: 

file. issue: 
identification file. 
isdigit,/ isalpha, 
/islower, isdigit, 

news: print news 
maintain volume. 
Bessel functions. 
Bessel functions. j0, 
bj: the game of black 
functions. j0, jl, 
database operator. 
/nrand48, mrand48, 
processes. killall: 
process or a group of/ 
process. 

processes. 

interface. mem, 

quiz: test your 

between 3-byte integers/ 
long integer and/ a64l, 
/copy file systems with 
systems with/ volcopy, 
scanning and processing 
/arithmetic 

cpp: the C 

includes: determine C 
/command programming 
/ckpacct, dodisk, 

shl: shell 

/srand48, seed 48, 
common object files. 
object file. Idclose, 
archive header of a/ 
object file for/ Idopen, 
a common object file. 


parts of/ frexp, 

file access routines. 
header of a common/ 
symbol name for common/ 
manipulate/ Idlread, 
Idlread, Idlinit, 

Idlitem: manipulate/ 

to line number entries/ 
number entries/ ldlseek, 
relocation/ ldrseek, 
Idshread, 
indexed/named/ Idsseek, 
optional file header of / 
common object file for/ 
to relocation entries/ 


5/86 


isgraph, isentrl,/ .... . etype(3C) 
islower, isdigit,/ . ... . . ctype(3C) 
isprint, isgraph,/ .. . . « etype(3C) 
ispunct, isprint,/ .....- ety pe(3C) 
isspace, ispunct,/ ... . - ctype(3C} 
issue a shell command. . . . system(3S) 
issue identification... .- issue(4) 
issue: issue . 6 2 2 ee - issue(4) 
isupper, islower, . .» . . ~ etype(3C) 
isxdigit, isalnum,/ ... . - etype(3C) 
items. . .... +++. news(l) 

iv: initialize and . ... . . iv(1) 

jO, j1, jn, yO, yl, yn: . . . . bessel(3M) 
jl, jn, yO, yl,yn: ..... bessel(3M) 
jack... eee ee eee « bj(6) 

jn, yO, yl, yn: Bessel - + « « bessel(3M) 
join: relational ..... © join(1) 
jrand48, srand48,/ . . . . . drand48(3C) 
kill all active ..... .. killall(1M) 
kill: send a signal to a - » kill(2) 

kill: terminatea ... . © © kill(1) 
killall: kill all active . . killall(1M) 
kmem: system memory . . . mem(7) 
knowledge. . 2... + + quiz(6) 
13tol, Itol3: convert . . « « 13tol(3C) 
164a: convert between - + 2641(3C) 
label checking. .. + + + + volcopy(1M) 
labelit: copy file . . . . . . volcopy(1M) 
language. awk: pattern . . awk(1) 
language. - - ~~. + + + be(1) 
language preprocessor. . . . cpp{1) 
language preprocessor/ . . . includes(1) 
language. » « . » « + « » « sh(1) 
lastlogin, monacct,/ + » » acctsh(1M) 
layer manager. ... . ~~ shi(1) 
Icong48: generate/ . . - . « drand48(3C) 
Id: link editor for... . ~ Id(1) 
Idaclose: close a common . .« Idclose(3X) 


Idahread: read the .... 
Idaopen: open acommon .. . 
Idclose, Idaclose: close . . 
Ideeprom: load EEPROM. 
ldexp, modf: manipulate 
Idfen: common object 
Idfhread: read the file 
ldgetname: retrieve 
Idlinit, Idlitem: ... 
Idlitem: manipulate line/ 
Idlread, Idlinit, ...... 
Idiseek, Idniseek: seek 2.2» 
Idniseek: seek toline . ... 
Idnrseek: seek to 
Idnshread: read anf ... 
Idnsseek: seek toan ....- 
Idohseek: seek tothe ... 
Idopen, Idaopen: open a 
ldrseek, Idnrseek: seek 


ee 2 © 
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- Idahread(3X) 


Idopen(3X) 


- Idclose(3X) 
- Ideeprom(1M) 
- » frexp(3C) 
- + Idfen(4) 
. « Idfhread(3X) 
- Idgetname(3X) 
- « Idlread(3X 
- Idlread(3X 


Idiseek(3X 
Idlseek(3X 
Idrseek(3X) 
ldshread(3X) 
Idsseek (3X) 


) 
Hisar 
) 
) 


- Idohseek(3X) 
. Idopen(3X) 
. ldrseek(3X) 


read an indexed/named/ 
to an indexed/named/ 
index of a symbol table/ 
indexed symbol table/ 
symbol table of a/ 
getopt: get option 

for simple lexical / 
programs for simple 
update. lsearch, 
Volume Home Blocks/ 
to subroutines and 
relation for an object 

ar: archive and 

ulimit: get and set user 
/an out-going terminal 
/type, modes, speed, and 
/type, modes, speed, and 
line: read one 

common object/ linenum: 
/\dlitem: manipulate 
/ldnlseek: seek to 

strip: strip symbol and 
nl: 

selected fields of each 
/requests to an LP 

Ipset: set parallel 

Ipr: 


update. Isearch, Ifind: 
col: filter reverse 

entries in a common/ 
/attach and detach serial 
comm: select or reject 
for uucp communications 
output/ fold: fold long 
head: give first few 

uniq: report repeated 
/files or subsequent 

or/ paste: merge same 
link, unlink: exercise 
object files. Id: 
/common assembler and 


ep, In, mv: copy, 

link: 

link and unlink system/ 
from proto file; set 
checker. 

directory. Is: 

statistics for a/ ff: 

get entries from name 
bcheck: print out the 
file. nm: print name 
processed by/ checklist: 
protocols. protocols: 
services. services: 
network. hosts: 
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ldshread, Idnshread: .... 
Idsseek, Idnsseek: seek .. © 
Idtbindex: compute the .. 
Idtbread: read an 
Idtbseek: seek tothe .... 
letter from argument/ ... 
lex: generate programs ... 
lexical tasks. /generate 

lfind: linear search and .. 


Idshread(3X) 
Idsseek(3X) 
Idt bindex(3X) 
Idtbread(3X) 
Idtbseek(3X) 
getopt(3C) 
lex(1) 


» lex(1) 
- Isearch(3C) 


libdev: manipulate... .. libdev(3X) 
libraries. /introduction . . intro(3) 
library. /find ordering . . . lorder(1) 
library maintainer for/ . . . ar(1) 
limits. 2 2 2. eee eee ulimit(2) 
line connection. . . . ~~ + dial(3C) 
line discipline. .....-. getty(1M) 
line discipline. ... . + ~ uugetty(1M) 
line. 2 2 eee eee e © © line(1) 
line number entries ina . . linenum(4) 
line number entries of a/ . . Idlread(3X) 
line number entries of a/ . . Idlseek(3X) 
line number information/ . strip(1) 
line numbering filter. .. . ni(1) 
line of a file. /eutout . . . cut(1) 
line printer. . . . . . ~ © © Ip(l) 
line printer options. . . . ~ Ipset(1M) 
line printer spooler. . . ~ ~ Ipr(1) 
line: read one line. . - . « - line(1) 
linear search and... ~ « Isearch(3C) 
line-feeds. 2... +... ~ col(l) 
linenum: line number . . . linenum(4)} 
lines as network/ .. . . ~ slattach(1NM) 
lines common totwo/ .. . comm(1) 
lines. /file ..... + + « Devices(5) 
lines for finite width . .. . fold(1) 
lines, 6 ew we ee © « « head(1) 
lines in afile. . ... +. . » uniq(1) 
lines of one file. . . 2. 2 es paste(1) 
lines of several files . . . . paste(1) 
link and unlink system/ . . link(1M) 
link editor for common . . . 1Id(1) 
link editor output... .. a.out(4) 
link: link toafile. .. .. ~ link(2) 
link or move files. 2... ep(1) 
link toafile 2... - +s link(2) 
link, unlink: exercise . . . . link(1M) 
links based on. /lists . . . qlist(1) 
lint: aC program ..... lint(1) 
list contents of ..... ~ Is(1) 
list file namesand ..... ff(1M) 
list. nlist: sees a; oho Ne nlist(3C) 
list of blocks/ . 2. ee eee bcheck(1M) 
list of common object... nm(1) 
list of file systems .. . . . checklist(4) 
list of Internet...» . «. protocols(4N) 
list of Internet... ~~ . services(4N) 
list of nodeson . 2... -- hosts(4N) 
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by terminal/ ttytype: 
uuname: 

handle variable argument 
of a varargs argument 
on a socket. listen: 
connections on a/ 
/construct argument 
qlist: print out file 
move files. ep, 
Ideeprom: 

drivers: 

mktunedrv: make a 
Iddrv: manage 
drvbind: access 
asctime, tzset:/ ctime, 
as the/ conlocate: 

for command. path: 
end, etext, edata: last 
data in memory. plock: 
files. 

access to regions of a/ 
lockf: record 

gamma: 

newgrp: 

exponential,/ exp, 
exponential,/ exp, log, 
/pow, sqrt: exponential, 
uulog: output 

process a report of 
network. rwho: who is 
getlogin: get 

logname: get 

cuserid: get character 
logname: return 
passwd: change 

rlogin: remote 

rlogind: remote 


a C shell environment at 
up an environment at 


name of user. 

/\64a: convert between 
sputl, sgetl: access 
3-byte integers and 
width output/ fold: fold 
setjmp, 

relation for an object/ 
make a 

nice: run a command at 
requests to an LP line/ 
/requests to an 
interface. 

disable: enable/disable 
/\pmove: start/stop the 
reject: allow/prevent 
lpadmin: configure the 
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list of terminal types... . 
list UUCP system names. . . 
list. varargs: 
list. /formatted output .. 
listen for connections ... 
listen: listen for 
list(s) and execute/  .... 
lists from proto file;/ ... 
In, mv: copy, link or . 2... 
load EEPROM. 
loadable device drivers. .. 
loadable driver for/ .... 
loadable drivers. ..... 
loadable drivers. ..... 
localtime, gmtime, ..... 
locate a terminal touse .. 
locate executable file . ... 
locations in program. ... 
lock process, text, or . 2.» 
lockf: record lockingon .. 
locking: exclusive ..... 
locking on files. 
log gamma function. . ... 
log in to a new group. ... 
log, logl0, pow, sqrt: . .. 
log10, pow, sqrt: 
logarithm, power, square/. 
logfile information. .... 
logged errors. errpt: . ... 
logged in on local 
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Jogin name. . 2s we eee 
login name. .. 6. 2s. eee 
login name of the user. . . . 
login name of user. . 2... 
login password. . 2. 2 «es 
login, 2 eee eve vee 
login server. 2. 2. ee eee 
login: signon. . 2. 2 e+ eee 
login time. /setting up .. . 
login time. /setting .... 


logname: get login name. . . 
logname: return login ... 
long integer and base-64/ . 
long integer dataina/ ... 
long integers. /between . . 
long lines for finite 
longjmp: non-local goto. .. 
lorder: find ordering 
lost+found directory for fsck 
low priority. 
Ip, cancel: send/cancel 
LP line printer. 
lp: parallel printer ..... 
LP printers. enable, 
LP request scheduler and/ . 
LP requests. accept, . ... 
LP spooling system. .... 
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ttytype(4) 
uuname(1C) 
varargs(5) 
vprintf(3S) 
listen(2N) 
listen(2N) 
xargs(1) 
qlist(1) 

cp(1) 
Ideeprom(1M) 
drivers(7) 
mktunedrv(1M) 
Iddrv(1M) 
Iddrv(2) 
ctime(3C) 
conlocate(1M) 
path(1) 
end(3C) 
plock(2) 
lockf(3C) 
locking(2) 
lock{(3C) 
gamma(3M) 
newgrp(1) 
exp(3M) 
exp(3M) 
exp(3M) 
uulog(1C) 
errpt(1M) 
rwho({1N) 
getlogin(3C) 
logname(1) 
cuserid(3S) 
logname(3X) 
passwd(1) 
rlogin(1N) 
rlogind(1NM) 
login(1) 
cprofile(4) 
profile(4) 
logname(1) 
logname(3X) 
a641(3C) 
sputl(3X) 
13tol(3C) 
fold(1) 
setjmp(3C) 
lorder(1) 


mklost+found(1M) 


nice(1) 


. enable(1) 


Ipsched(1M) 
accept(1M) 
Ipadmin(1M) 


Ipstat: print 

LP spooling system. 
LP/ Ipsched, Ipshut, 
spooler. 

start/stop the LP/ 
printer options. 
start/stop the/ lpsched, 
information. 

drand48, erand48, 
directory. 

search and update. 
file pointer. 

3-byte integers/ 13tol, 


values. values: 

/long integer data in a 
formatting a/ mptx: the 
formatting/ mm: the MM 
typesetting/ mv: a troff 
m4: 

entries in this/ man: 
formatted with the MM 
mail to users or read 

to users or read mail. 
mail. mail, rmail: send 
message processing/ 
/free, realloc, calloc: 
/mallopt, mallinfo: fast 
regenerate groups/ make: 
iv: initialize and 

ar: archive and library 
an SCCS file. delta: 
mkdir, mkdirs: 

special or/ mknod: 
mktunedrv: 
mklost+found: 
mktemp: 

object file. mkifile: 

and regenerate groups/ 
mkhosts: 

banner: 

terminal/ script: 
memory/ /calloc, mallopt, 
calloc: main memory / 
calloc, mallopt,/ 

/free, realloc, calloc, 
formatting entries in/ 
entries in this manual. 
/tfind, tdelete, twalk: 
/hereate, hdestroy: 
\ddrv: 

form-based network 
window: window 

wm: window 

shi: shell layer 

fwtmp, wtmpfix: 
/\dlinit, Idlitem: 
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LP status information. .. . 
Ipadmin: configure the 
Ipmove: start/stop the .. . 
Ipr: line printer 
Ipsched, Ipshut, Ipmove: . . 
\pset: set parallel line 
Ipshut, I|pmove: .....-. 
Ipstat: print LP status 
lrand48, nrand48,/  ...- 
Is: list contents of ..... 
Isearch, Ifind: linear . ... 
Iseek: move read/write . . . 
Itol3: convert between .. 
m4: macro processor. .. « 
machine-dependent .... 
machine-independent/ ... 
macro package for . 2... e 
macro package for . . 2 « « 
macro package for ..... 
macro processor. 
macros for formatting ... 
macros. /documents . .« « 
mail. mail, rmail: send 
mail, rmail: send mail ... 
mail to users or read . . ~~ 
mailx: interactive . . 
main memory allocator. .. 
main memory allocator. . 
maintain, update, and . . 


maintain volume. 
maintainer for portable/ 
make a delta (change) to . . 
make a directory. ..... 
make a directory, ora . « « 
make a loadable driver/ . 

make a lost+found dinectory/ 
make a unique file name. 
make an ifile from an ... 
make: maintain, update, . . 
make node name commands. 
make posters. 
make typescript of .... 
mallinfo: fast main ...-. 
malloc, free, realloc, 2... . 
malloc, free, realloc, . .. 
mallopt, mallinfo: fast/  . . 
man: macros for . .. 2. « « 
man, manprog: print... . 
manage binary search/ .. . 
manage hash search/  .. - 
manage loadable drivers. . . 
management. netman: .. « 
management primitives. . . 
management. 
manager. 
manipulate connect/ . . + « 
manipulate line number/ . . 


ee 
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Ipstat(1) 
Ipadmin(1M) 
Ipsched(1M) 
Ipr(1) 
Ipsched(1M)} 
Ipset(1M) 
Ipsched(1M) 
Ipstat(1) 
drand48(3C) 
1s(1) 
lsearch(3C) 
Iseek(2) 
I3tol(3C) 
m4(1) 
values(5) 
sputl(3X) 
mptx(5) 
mm(5) 

my(5) 

m4(1) 
man(5) 
mm(1) 
mail(1) 
mail(1) 
mail(1) 
mailx(1) 
malloc(3C) 
malloc(3X) 
make(1) 


delta(1) 
mkdir(1) 
mknod(2) 
mktunedrv(1M) 
mklost+found(1M) 
mktemp(3C) 
mkifile(1M) 
make(1) 
mkhosts(1NM) 
banner(1) 
script(1) 
malloc(3X) 
malloc(3C) 
malloc(3X) 
malloc(3X) 
man(5) 

man(1) 
tsearch(3C) 
hsearch(3C) 
lddrv(iM) 
netman(1NM) 
window(7) 
wm(1) 

shl(1) 
fwtmp(1M) 
Idlread(3X) 


frexp, ldexp, modf: 
tables. route: manually 
Blocks (VHB). libdev: 
/Internet address 

in this manual. man, 
the cat files for the 
print entries in this 
entries in this 

routing tables. route: 
terminal input/ rsterm: 
set. ascii: 

files. diffmk: 

set file-creation mode 
and get file creation 
information/ master: 
information table. 
expression compile and 
constants. math: 
constants. 

/neqn, checkeq: format 
function. 


maze: generate a 

vax: provide truth/ 
interface. 

memepy, memset: memory / 
memset: memory/ memcecpy, 
memory/ memecpy, memchr, 
memccpy, memchr, mememp, 
realloc, calloc: main 
/mallinfo: fast main 

shmctl: shared 

semaphore set or shared 
mem, kmem: system 
/mememp, memcpy, memset: 
shmop: shared 

text, or data in 

shmget: get shared 

memchr, memcmp, memepy, 
sort. sort and/or 
accounting/ acctmerg: 
several files or/ paste: 
messages. 

operations. msgctl: 
/recvfrom: receive a 

msgop: 

mailx: interactive 

msgget: get 

set or/ iperm: remove a 
send, sendto: send a 

mesg: permit or deny 
sys_nerr: system error 
directory. 

directory. mkdir, 

system. 

/software using the 
commands. 
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manipulate parts of/ . . 
manipulate the routing . 
manipulate Volume Home 
manipulation routines. . 
manprog: print entries . 
manual. catman: create 
manual. man, manprog: 
manual. /for formatting 
manually manipulate the 
manually start and stop 
map of ASCII character 
mark differences between 
mask. umask: .... 
mask. umask: set .. . 
master device . 2... « 
master: master device . 
match routines. /regular 
math functions and 
math: math functions and 
mathematical text for/ . 
matherr: error-handling 
maze: generate a maze. . 
maze. . «eee eee 
mc68k, pdp11, u3b, u3b5, 


mem, kmem: system memory 


memecpy, memchr, mememp, 


memcehr, mememp, memepy, 
memcmp, memcpy, memset: 


memepy, memset: memory/ 


memory allocator. /free, 
memory allocator. 
memory control/ ... 
memory id. /queue, .. 
memory interface. ... 
memory operations. . « 
memory operations. . . 
memory. /lock process, 

memory segment. 


memset: memory/ memcecpy, 


merge files. 
merge or add total .. 
merge same linesof .. 
mesg: permit ordeny . 
message control 
message from a socket. . 
message operations. . . 
message processing/ . . 
message queue. 
message queue, semaphore 
message to a socket. 
messages. 
messages. /sys_errlist, . 
mkdir, mkdirs: makea . 
mkdirs: make a 
mkfs: construct afile . 

mkfs(1) proto file/ . . . 

mkhosts: make node name 


ee @ © 8 


oe we we 
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frexp(3C) 
route(1NM) 
libdev(3X) 
inet(3N) 
man(1) 
catman(1) 
man(1) 
man(5) 
route(1NM) 
rsterm(1M) 
ascii(5) 
diffmk(1) 
umask(1) 
umask(2) 
master(4) 
master(4) 
regexp(5) 
math(5) 
math(5) 
eqn(1) 
matherr(3M) 
maze(6) 
maze(6) 
machid(1) 
mem(7) 
memory( 
memory( 
memory(3 
memory(3' 
malloe(3C 
malloe(3X 
shmetl(2) 
iperm(1) 
mem(7) 
memory(3C) 
shmop(2) 
plock(2) 
shmget(2) 
memory(3C) 
sort(1) 
acctmerg(1M) 
paste(1) 
mesg(1) 
msgctl(2) 
recv(2N) 
msgop(2) 
mailx(1) 
msgget(2) 
iperm(1) 
send(2N) 
mesg(1) 
perror(3C) 
mkdir(1) 
mkdir(1) 
mkfs(1M) 
qinstall(1) 
mkhosts(1NM) 


from an object file. 
lost+found directory / 
file. 

or a special or/ 

file name. 

relocate a PT or GT/ 
driver for tunable/ 
formatting/ mm: the 
formatted with the 
print/check documents/ 
for formatting/ 
documents, view graphs,/ 
system table. 

chmod: change 

umask: set file-creation 
chmod: change 

/set terminal type, 

/set terminal type, 

of/ frexp, Idexp, 

touch: update access and 
[set file access and 
/dodisk, lastlogin, 
execution profile. 
uusub: 


perusal. 

mount: 

system. mount, umount: 
system. 

setmnt: establish 
dismount file system. 
table. mnttab: 

mvdir: 

In, mv: copy, link or 
pointer. lseek: 

LP request scheduler and 
for formatting a/ 
/\rand48, nrand48, 
operations. 

queue. 

operations. 

package for typesetting/ 
files. cp, In, 


view graphs, and/ mmt, 
relocate a PT or/ mktpy, 
from i-numbers. 
mathematical text/ eqn, 
definitions for eqn and 
network management. 
status. 

/values between host and 
/endnetent: get 
/endhostent: get 

hosts: list of nodes on 
ifconfig: configure 

detach serial lines as 
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mkifile: make an ifile ... 
mklost+found: makea ... 
mknod: build special . . . - 
mknod: make a directory, . 
mktemp: make a unique .. 
mktpy, mvtpy: install or . . 
mktunedrv: make a loadable 

MM macro package for. . 
MM macros. /documents . 
mm, osdd, checkmm: .. . 
mm: the MM macro package 
mmt, mvt: typeset . 2... 
mnttab: mounted file 
MOdEG, i 6: ee ese ee es 
mode mask. 
mode of file. .. 2.2... 
modes, speed, and line/ . 
modes, speed, and line/. 
modf: manipulate parts .. 
modification times of a/ . - 
modification times. . .. 
monacct, nulladm,/ ... - 
monitor: prepare 
monitor uucp network. ... 
moo: guessing game. . .« - 
more, page: text . 2 . 2 « « 
mount a file system. .... 
mount and dismount file . . 
mount: mount afile ... . 
mount table. 
mount, umount: mount and 

mounted file system ... « 
move a directory. . . . . « 
move files. cp, ...- 
move read/write file ... - 
move requests. /the ...- 
mptx: the macro package . . 
mrand48, jrand48,/ 
msgctl: message control . - 
Mmsgget: get message . « « « 
msgop: message 
mv:atroff macro ....- 
my: copy, link or move . . - 
mvdir: move a directory. . . 
mvt; typeset documents, .. 
mvtpy: install or 
ncheck: generate names. .« 
neqn, checkeq: format ... 
neqn. /special character .. 
netman: form-based ... » 
netstat: show network ... 
network byte order. . . + « 
network entry. 
network host entry. ... 
network. .. 2... ee eee 
network interface/ 
network interfaces. /and . .- 
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mkifile(1M) 
mklost+found(1M) 
mknod(1M) 
mknod(2) 
mktemp(3C) 
mktpy(1) 
mktunedrv(1M) 
mm(5) 

mm(1) 

mm(1) 

mm(5) 
mmt(1) 
mnttab(4) 
chmod(1) 
umask(1) 
chmod(2) 
getty(1M) 
uugetty(1M) 
frexp(3C) 
touch(1) 
utime(2) 
acctsh(1M) 
monitor(3C) 
uusub(1M) 
moo(6) 
ey 
mount(2) 
mount(1M) 
mount(2) 
setmnt(1M) 
mount(1M) 
mnttab(4) 
mvdir(1M) 
cp(1) 

Iseek(2) 
Ipsched(1M) 
mptx(5) 
drand48(3C) 
msgctl(2) 
msgget(2) 
msgop(2) 
mv(5) 

ep(1) 
mvdir(1M) 
mmt(1) 
mktpy(1) 
ncheck(1M) 
eqn(1) 
eqnchar(5) 
netman(1NM) 
netstat(iN) 
byteorder(3N) 
getnetent(3N) 
gethostent(3N) 
hosts(4N) 
ifconfig(1NM) 
slattach(1NM) 


netman: form-based 
status of nodes on local 
is logged in on local 
netstat: show 

stat: statistical 
uucpd: 

uusub: monitor uucp 
numbers for the/ 
format of a text file. 
group. 

news: print 


a process. 
process by changing 

low priority. 

filter. 

name list. 

common object file. 
mkhosts: make 

Internet address from 
rwhod: 

/display status of 

hosts: list of 

immune to hangups and/ 
setjmp, longjmp: 
/erand48, lrand48, 


mathematical text for 
tbi: format tables for 
eqn/ deroff: remove 
values/ htonl, htons, 
htonl, htons, ntohl, 
null: the 


/lastlogin, monacct, 

nl: line 

number: convert Arabic 
/access graphical and 

to/ convert: convert 
routines. Idfen: common 
selected parts of an 
/l\daopen: open a common 
/entries of a common 
Idaclose: close a common 
file header of a common 
of a section of a common 
file header of a common 
of a section of a common 
header of a common 
/section of a common 
table entry of a common 
table entry of a common 
symbol table of a common 
entries in a common 
make an ifile from an 
name list of common 
information for a common 
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network management. 
network. /display ..... 
network. rwho: who .... 
network status. 
network useful with/ ... 
network uucp server. .. « 
network. 
networks: names and 
newform: change the .... 
newgrp: logintoanew .. 
news items. 
news: print news items. . . 
Nice: change priority of . . . 
nice. /of running 
nice: run a command at 
nl: line numbering ..... 
nlist: get entries from ... 
nm: print name list of ... 
node name commands. .. « 
node name. /set DARPA. 
node status server. . 
nodes on local network. . . 
nodes on network. ‘ 
nohup: run a command 
non-local goto. 


ee ee 


- netman(1NM) 


ruptime(1N) 
rwho(1N) 
netstat(1N) 
stat(1G) 
uucpd(1NM) 
uusub(1M) 


« networks(4N) 


newform(1) 
newgrp(1) 
news(1) 
news(1) 
nice(2) 
hs 1) 


> al(1) 


nlist(3C) 
nm(1) 

mk hosts(1NM) 
setaddr(1NM) 
rwhod(1NM) 
ruptime(1N) 
hosts(4N) 


. . nohup(1) 
- setjmp(3C) 


nrand48, mrand48,/ . . . . drand48(3C) 
nroff: format text. . . . . . nroff(1) 
nroff or troff. /format . . . eqn(1) 

nroff or troff. . . 2. + + + tbi(i) 
nroff/troff, tbl, and .. . . deroff(1) 
ntohl, ntohs: convert . . . . byteorder(3N) 
ntohs: convert values/ . . . byteorder(3N) 
null file. 2... 6 ee ~~ nuli(7) 

null: the nullfile. . . . . . null(7) 
nulladm, pretmp,/ .. . » « acctsh(1M) 
numbering filter. ... . . ni(1) 
numerals to English. . . . . number(6) 
numerical commands. .. . graphics(1G) 
object and archive files . . . convert(1) 
object fileaccess .... > Idfen(4) 
object file. dump: dump - dump(1) 
object file for reading. . . . Idopen(3X) 
object file function. . . . . Idlread(3X) 
object file. Idclose, . . . . Idclose(3X) 
object file. /readthe . . . Idfhread(3X) 
object file. /entries . . . . Idlseek(3X) 


object file. 
object file. 
object file. 
object file, 
object file. 


/optional 
fentries . 2... 
/section 


. Idohseek(3X) 


Idrseek(3X) 


. Idshread(3X) 


Idsseek(3X) 


. Idtbindex(3X) 


object file. /symbol . . . . Idtbread(3X) 
object file. /tothe . . Idtbseek(3X) 
object file. /number . . . . linenum(4) 
object file. mkifile: . . . . mkifile(1M) 
object file. nm: print - . nm(l) 
object file. /relocation - reloc(4) 
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header for a common 
/from a common 
/symbol name for common 
format. syms: common 
file header for common 
cpset: install 

link editor for common 
section sizes of common 
ordering relation for an 
od: 

functions. 


file/ ldopen, ldaopen: 
i-node. openi: 

fopen, freopen, fdopen: 
dup: duplicate an 
writing. open: 

or writing. 

specified by i-node. 
profiler. prf: 

/prfde, prfsnap, prfpr: 
memepy, memset: memory 
msgctl: message control 
msgop: message 
semaphore control 
semop: semaphore 
shared memory control 
shmop: shared memory 
strespn, strtok: string 
terminal independent 
relational database 
/copy file systems for 
/CRT screen handling and 
functions. ocurse: 
argument/ getopt: get 
a/ Idohseek: seek to the 
fentl: file control 

stty: set the 

getopt: parse command 
parallel line printer 
/setsockopt: get and set 
object/ lorder: find 
/or a special or 
print/check/ mm, 

dial: establish an 

and link editor 

lines for finite width 
information, uulog: 
/print formatted 
sprintf: print formatted 
stop terminal input and 
and/ /accton, acctwtmp: 
file. chown: change 
chown, chgrp: change 
compress and expand/ 
and optimization 

mptx: the macro 
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object file. /section . . 
object file. 
object file symbol table/ 
object file symbol table 

object files. filehdr: . . 
object files in binary/  . 
object files. Id: 
object files. /print . . 
object library. /find . . 
octaldump. ..... 
ocurse: optimized screen 
od: octaldump. .... 
open acommon object . 
open a file specified by . 
open astream. «2. 6 « « 
open file descriptor. .. 
open for reading or .. 
open: open for reading . 
openi: openafile ... 
operating system ... 
operating system/ ... 


operations. /mememp, . 
Operations. ...e.- 
operations. 2... 2 ee 
operations. semctl: .. 
Operations. ...e.e- 
operations. shmetl: . . 
operations. . 2. ++. 
operations. /strspn, . . 


operations. /tputs: . . 
operator. join: 
optimal access time. . . 
optimization package. . 
optimized screen 

option letter from 
optional file header of . 
options. 
options for a terminal. . 
options. 
options. Ipset: set 
options on sockets. .. 
ordering relation for an 

ordinary file. 
osdd, checkmm: .... 
out-going terminal line/ 

output. /assembler . . 
output device. /long 
output logfile 
output of a varargs/ . . 
output. /fprintf, ... 
output. /startand .. 
overview of accounting . 
owner and group ofa . 
owner or group. 
pack, peat, unpack: .. 
package. /handling 
package for formatting a/ 


oe ee 
eee 
eee 
oe we ee we 
ee © ee we ew 
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senhdr(4) 
strip(1) 
Idgetname(3X) 
syms(4) 
filehdr(4) 
cpset(1M) 
\d(1) 
size(1) 
lorder(1) 
od(1) 
ocurse(3X) 
od(1) 
Idopen(3X) 
openi(2) 
fopen(3S) 


profiler(1M) 
memory(3C) 
msgctl(2) 
msgop(2} 
semcetl(2) 
semop(2) 
shmetl(2) 
shmop(2) 
string(3C) 
termcap(3X) 
join(1) 
dcopy(1M) 
curses(3X) 
ocurse(3X) 
getopt(3C) 
Idohseek(3X) 
fentl(5) 
stty(1) 
getopt(1) 
Ipset(1M) 
getsockopt(2N) 
lorder(1) 
mknod(2) 
mm(1) 
dial(3C) 
a.out(4) 
fold(1) 
uulog(1C) 
vprintf(3S) 
printf(3S) 
rsterm(1M) 
acct(1M) 
chown(2) 
chown(1) 
pack(1) 
curses(3X) 
mptx(5) 


mm: the MM macro 
view/ mv: a troff macro 
system activity report 
buffered input/output 
communication 

more, 

TEKTRONIX 4014/ 4014: 
options. Ipset: set 
interface. Ip: 

772/ xmset: set drive 
network interface 

/ process group, and 
getopt: 

password. 


/endpwent, fgetpwent: get 
putpwent: write 
passwd: 

getpass: read a 

passwd: change login 
checkers. pwek, grpck: 
of several files or/ 

file for command. 
deliver portions of 
working/ getcwd: get 
search a file for a 
processing/ awk: 

until signal. 

and expand files. pack, 
to/from a/ popen, 
provide truth/ mc68k, 
get name of connected 
the UUCP directories and 
mesg: 

package for formatting a 
ptx: 

file format. acct: 
/command summary from 
sys_errlist, sys_nerr:/ 
soft-copy/ pg: file 
more, page: text 

for soft-copy/ 

split: split a file into 
interprocess channel. 
tee: 

popen, pclose: initiate 
fish: 

text, or data in/ 
interface. 

subroutines. 

/ftell: reposition a file 
move read/write file 
pipe to/from a process. 
library maintainer for 
/dirname: deliver 
banner: make 

exp, log, logl0, 
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package for formatting/ 

package for typesetting 

package. /sa2,sadc: . . 
package. /standard .. 
package. /interprocess . 
page: text perusal. . . . 
paginator forthe ... 
parallel line printer . . 
parallel printer 
parameters for Xylogics 

parameters. /configure 

parent process IDs. . . 
parse command options. 

passwd: change login . 
passwd: password file. . 
password file entry. . . 
password file entry. . . 
password file. . . 2... 
password. 
password. 
password/group file . . 
paste: merge same lines 
path: locate executable 
path names. /dirname: 
path-name of current 

pattern. /egrep, fgrep: 
pattern scanning and. 
pause: suspend process . 
peat, unpack: compress 

pelose: initiate pipe .. 


pdpll, u3b, u3b5, vax: . . 


peer. getpeername: . . 
Permissions file. /check 

permit or deny messages. 
permuted index. /macro 
permuted index. . .. 
per-process accounting . 
per-process accounting/ 

perror, errno, 
perusal filter for .... 
perusal. 
pg: file perusal filter .. 
pieces. 
pipe: create an 
pipe fitting. ...... 
pipe to/from a process. 

play “Go Fish”. .... 
plock: lock process, .. 
plot: graphics . 2... 
plot: graphics interface . 
pointer in a stream. 
pointer. lseek: 
popen, pclose: initiate . 
portable archives. /and 

portions of path names. 

posters. 
pow, sqrt: exponential,/ 


oe 8 
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mm(5) 
my(5) 
sar(1M) 
stdio(3S) 
stdipc(3C) 


ifconfig(1NM) 
getpid(2) 
getopt(1) 
passwd(1) 
passwd(4) 
getpwent(3C) 
putpwent(3C) 
passw d(4) 
getpass(3C) 
passwd(1) 
pwek(1M) 
paste(1) 
path(1) 
basename(1) 
getcwd(3C) 
grep(1) 
awk({1) 
pause(2) 
pack(1) 
popen(3S) 
machid(1) 
getpeername(2N) 
uucheck(1M) 
mesg(1) 
mptx(5) 
ptx(1) 
acct(4) 
acctcms(1M) 
perror(3C) 
pg(1) 
more(1) 
pg(1) 

split(1) 
pipe(2) 
tee(1) 
popen(3S) 
fish(6) 
plock(2) 
plot(4) 
plot(3X) 
fseek(3S) 
Iseek(2) 
popen(3S) 
ar(1) 
basename(1) 
banner(1) 
exp(3M) 


/exponential, logarithm, 
bre, beheckre, re, 


/monacct, nulladm, 
/nulladm, pretmp, 
text for/ cw, checkew: 
profile. monitor: 

cpp: the C language 
/determine C language 
file. unget: undoa 
profiler. 

prfid, prfstat, 

prfsnap, prfpr:/ 
/prfstat, prfdc, prfsnap, 
prfld, prfstat, prfde, 
prfpr: operating/ prfid, 
of/ gps: graphical 
types. types: 

window management 
hopefully/ fortune: 
prs: 

date: 

cal: 

count of a file. sum: 
editing activity. sact: 
manual. man, manprog: 
cat: concatenate and 
pr: 

of/ /vfprintf, vsprintf: 
/fprintf, sprintf: 
information. Ipstat: 
common object file. nm: 
CTIX system. uname: 
news: 

from proto file;/ qlist: 
blocks/ bcheck: 
acctcom: search and 
trpt: 

common object/ size: 
and names. id: 

mm, osdd, checkmm: 
Ip: parallel 

requests to an LP line 
a PT or GT local 
Ipset: set parallel line 
Ipr: line 

enable/disable LP 
sprintf: print / 

run a command at low 
nice: change 

process/ renice: alter 
logged errors. errpt: 
acct: enable or disable 
acctprel, acctpre2: 
/search and print 
alarm: set a 

process/ times: get 
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power, square root/ . . 
powerfail, drvload:/ .. 
pr: print files. . . 2... 
pretmp, prdaily,/ ... 
prdaily, prtacct,/ 
prepare constant-width 
prepare execution .. . 
preprocessor. 
preprocessor include/ 
previous get of an SCCS 
prf: operating system . 
prfde, prfsnap, prfpr:/ . 
prfid, prfstat, prfde, .. 
prfpr: operating system/ 
prfsnap, prfpr:/ 
prfstat, prfde, prfsnap, . 
primitive string, format 
primitive system data . 
primitives. window: . . 
print a random, 
print an SCCS file. .. 
print and set the date. . 
print calendar. 
print checksum and block 
print current SCCS file 
print entries inthis . . 
print files. 
print files. 
print formatted output 
print formatted output. 
print LP status 
print name list of 
print name of current . 
print news items. ... 
print out file lists ... 
print out the list of . . 
print process accounting/ 
print protocol trace. . . 
print section sizes of . . 
print user and group IDs 
print/check documents/ 
printer interface. 
printer. /send/cancel . 
printer. /or relocate . . 
printer options. .... 
printer spooler, .... 
printers. /disable: .. . 
printf, fprintf, .... 
priority. nice: ..... 
priority of a process. . . 
priority of running .. 
process areportof... 
process accounting. . . 
process accounting. .. 
process accounting/ . . 
process alarm clock. . . 
process and child .. . 


ee ec ee 
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exp(3M} 
bre(1M) 
pr(1) 
acctsh(1M) 
acctsh(1M) 
ew(1) 
monitor(3C} 
epp(1) 
includes(1) 
unget(1) 
pri(7) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
gps(4) 
types(5) 
window(7) 
fortune(6) 
prs(1) 
date(1) 
cal(1) 
sum(1) 
sact(1) 
man(1) 
cat(1) 

pr(1) 
vprintf(3S) 
printf(3S)} 
Ipstat(1) 
nm(1) 
uname(1) 
news(1) 
qlist(1) 
beheck(1M) 
acctcom(1) 
trpt(1NM) 


enable(1) 
printf(3S) 
nice(1) 
nice(2) 
renice(1) 
errpt(1M) 
acct (2) 
acct pre(1M) 
acctcom(1) 
alarm(2) 
times(2) 


/priority of running 
init, telinit: 

/time a command; report 
exit, _exit: terminate 
fork: create a new 
/getppid: get process, 
setpgrp: set 

group, and parent 
script for the init 

kill: terminate a 
change priority of a 
kill: send a signal toa 
initiate pipe to/from a 
/getpgrp, getppid: get 
ps: report 

in memory. plock: lock 
get process and child 
wait: wait for child 
ptrace: 

pause: suspend 

await completion of 
/list of file systems 

a process or a group of 
killall: kill all active 

or file/ fuser: identify 
/pattern scanning and 
chalt: terminate all 
/interactive message 
m4: macro 

truth value about your 
data. 

function. 

profile. 

prof: display 

prepare execution 
profil: execution time 
environment at login/ 
function. prof: 

prf: operating system 
prfpr: operating system 
sadp: disk access 
/command 

/using the mkfs(1) 
/out file lists from 
/endprotoent: get 
Internet File Transfer 
telnetd: DARPA TELNET 
Trivial File Transfer 
user interface to TELNET 
to the DARPA TFTP 
trpt: print 
ACU/modem calling 
Internet protocols. 

list of Internet 

update: 

facts. arithmetic: 
/pdp11, u3b, u3b5, vax: 
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process by changing/ .. 
process control/ ..... 
process data and system/ 

process. 
process. 
process group, and/ ... 
process group ID. .... 
process IDs. /process . . 
process. inittab: .... 
process. 
process. nice: . 2. . e « 
process or a group of/ .. 
process. popen, pclose: .. 
process, process group,/ . 
process status. 
process, text, or data .. 
process times. times: .. 
process to stop or/ oe ays 
process trace. 
process until signal. .. . 
process. wait: ...... 
processed by fsck. . ..~ 
processes. /asignalto .. 
processes. 
processes using afile ... 
processing language. .. . 
processing. shutdown, . . 
processing system. . . . - 
processor. 
processor type. /provide . 
prof: display profile ... 
prof: profile withina ... 
profil: execution time .. 
profile data. 
profile. monitor: . . 
profile. 
profile: setting up an 
profile withina ..... 
profiler. 
profiler. /prfsnap, ... - 
profiler. 
programming language. . 
proto file database. ... 
proto file; set links/ .. . 
protocol entry. ....-. 
Protocol server. /DARPA 
protocol server. . . . « « 
Protocol server. /DARPA 
protocol. telnet: . 2... 
protocol. /interface . . . 
protocol trace. «.« . «oe 
protocols. Dialers: ... . 
protocols: list of . .... 
protocols. protocols: . . . 
provide disk/ . ....+- 
provide drillin number. 
provide truth value/ ... 


oe © © we 


oe ee we ee 


ee ee we 
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renice(1) 
init(1M) 
timex(1) 
exit(2) 
fork(2) 
getpid(2) 
setpgrp(2) 
getpid(2) 
inittab(4) 
kill(1) 

nice(2) 

xill(2) 
popen(3S) 
getpid(2) 
ps(1) 
plock(2) 
times(2) 
wait(2) 
ptrace(2) 
pause(2) 
wait(1) 
checklist(4) 
kill(2) 
killall(1M) 
fuser(1M) 
awk(1) 
shutdown(1M) 
mailx(1) 
m4(1) 
machid(1) 
prof(1) 
prof(5) 
profil(2) 
prof(1) 
monitor(3C) 
profil(2) 
profile(4) 
prof(5) 

pri(7) 
profiler(1M) 
sadp(1M) 
sh(1) 
qinstall(1) 
qlist(1) 

get protoent(3N) 
ftpd(1NM) 
telnetd(1NM) 
tftpd(1NM) 
telnet(1N) 
tftp(1N) 
trpt(1NM) 
Dialers(5) 
protocols(4N) 
protocols(4N) 
update(1M) 
arithmetic(6) 
machid(1) 


true, false: 


/pretmp, prdaily, 
status. 

sxt: 

/uniformly distributed 
/install or relocate a 
download. tdl, gtdl, 


input stream. ungetc: 
putw: put character or/ 
put character or/ pute, 
value to environment. 
file entry. 

string on a stream. 
/getutid, getutline, 
putc, putchar, fpute, 
password /group file/ 
name. 

tape. 

qic: interface for 

verify software using/ 
lists from proto file;/ 


tput: 

msgget: get message 
iperm: remove a message 
qsort: 

immune to hangups and 
knowledge. 
random-number/ 
fortune: print a 

rand, srand: simple 
fsplit: split FORTRAN, 
system/ bre, bcheckre, 
command execution. 
ruserok: routines for/ 


getpass: 

table entry/ Idtbread: 
Idshread, Ildnshread: 
read: 

send mail to users or 
line: 


of a member/ Idahread: 
acommon/ Idfhread: 

a common object file for 
open: open for 

Iseek: move 

memory/ malloc, free, 
mallopt,/ malloc, free, 
system. 

reboot: 

/specify what to do upon 
socket. recv, recvfrom: 
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provide truth values. . 
prs: print an SCCS file. 
prtacct, runacct,/ 2... 
ps: report process .. . 
pseudo-device driver. . 
pseudo-random numbers. 
PT or GT local printer. 
ptdl: RS-232 terminal . 
ptrace: process trace. x 
ptx: permuted index. . 
push character back into 
putc, putchar, fpute, . . 
putchar, fputc, putw: . 
putenv: change or add . 
putpwent: write password 
puts, fputs: puta ... 
pututline, setutent,/ . . 
putw: put character or/ 
pwek, grpck: 
pwd: working directory 
qic: interface for QIC . 
QIC tape. 
qinstall: installand . . 
qlist: print out file . . . 
qsort: quicker sort. 
query terminfo database. 
queue. 
queue, semaphore set or/ 
quicker sort. 
quits. /run a command 
quiz: test your 
rand, srand: simple 
random, hopefully/ 
random-number generator. 
ratfor, or efl files. 
re, powerfail, drvload:  . 
remd: remote shell . . . 
remd, rresvport, .... 
rep: remote file copy. .- 
read a password. 
read an indexed symbol 
read an indexed/named/ 
read from file. 
read mail. mail, rmail: . 
read one line. 
read: read from file. . . 
read the archive header 
read the file header of . 
reading. /Idaopen: open 
reading or writing. .. 
read/write file pointer. . 
realloc, calloc: main .. 
realloc, calloc, . .. +. 
reboot: reboot the ... 
reboot the system. .. » 
receipt of asignal. .. . 
receive a message from a 


oe 
oe ee eo ee 
oe ee 
oe we 
oe 
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true(1) 
prs(1) 
acctsh(1M) 
ps(1) 

sxt(7) 
drand48(3C) 
mktpy(1) 
tdl(1) 
ptrace(2) 
ptx(1) 
ungetc(3S) 
putce(3S) 
pute(3S) 
putenv(3C) 
putpwent(3C) 
puts(3S) 
getut(3C) 
pute(3S) 
pwek(1M) 
pwd(1) 
gie(7) 
qic(7) 
qinstall(1) 
qlist(1) 
gsort(3C) 
tput(1) 
msgget(2) 
iperm(1) 
gsort(3C) 
nohup(1 


) 

) 
fortune(6) 

) 


fsplit(1) 
bre(1M) 
remd(1N) 
remd(3N) 
rep(1N) 
getpass(3C) 
ldtbread(3X) 
Idshread(3X) 
read(2) 
mail(1) 
line(1) 
read(2) 
Idahread(3X) 
ldfhread(3X) 
Idopen(3X) 
open(2) 
Iseek(2) 
malloc(3C) 
malloc(3X) 
reboot(1M) 
reboot(1M) 
signal(2) 
recv(2N) 


lockf: 

per-process accounting 
errdead: extract error 
connect accounting 
backup tape. free: 

a message from a/ 
message from a/ recv, 
ed, 

and execute regular/ 
expression compile. 
/maintain, update, and 
execute regular/ regemp, 
expression compile and/ 
/exclusive access to 
compile and/ regexp: 
compile. regemp: 
/compile and execute 
requests. accept, 

two/ comm: select or 
lorder: find ordering 
operator. join: 
information for a/ 
mktpy, mvtpy: install or 
/\dnrseek: seek to 

for a common/ reloc: 
/fabs: floor, ceiling, 
calendar: 

uux: CTIX to CTIX 
returning a stream to a 
uuxqt: execute 

return stream to a 
rhosts: 

rexecd: 

rep: 

rlogin: 

rlogind: 

execution. remd: 

rshd: 

Uutry: try to contact a 
ct: spawn getty toa 
SCCS file. rmdel: 
semaphore set or/ iperm: 
unlink: 

disk. dismount: 
directories. rm, rmdir: 
and eqn/ deroff: 

of running process by/ 
check and interactive 
file. unig: report 

clock: 

fsize: 

communication/ ipes: 
disk blocks. df: 

errpt: process a 

sade: system activity 
timex: time a command; 
ps: 
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record locking on files. . 
records. /summary from 
records and status/ .. 
records. /manipulate . 
recover files froma .. 
recy, recyfrom: receive . 
recvfrom: receivea .. 
red: text editor. 
regemp, regex: compile . 
regemp: regular 
regenerate groups of/ . 
regex: compile and . . . 
regexp: regular .... 
regions of afile. . .. . 
regular expression .. . 
regular expression ... 
regular expression. . . . 
reject: allow/prevent LP 

reject lines common to . 
relation for an object/ . 
relational database .. 
reloc: relocation 
relocatea PT orGT/ . 
relocation entries of a/ . 
relocation information . 
remainder, absolute/ . . 
reminder service. 
remote command/ ... 
remote command. /for . 


ee se 2 


eee 


remote command requests. 


remote command. rexec: 
remote equivalent users. 
remote execution server. 
remote file copy. 
remote login. 
remote login server. .. 
remote shell command . 
remote shell server. . « 
remote system with/ . . 
remote terminal. 
remove a delta from an 

remove a message queue, 
remove directory entry. 

remove exchangeable . . 
remove files or 
remove nroff/troff, tbl, . 
renice: alter priority . . 
repair. /consistency . . 
repeated lines ina ... 
report CPU time used. . 
report file size. 
report inter-process . . 
report number of free. 
report of logged errors. . 
report package. /sa2, . 
report process data and/ 
report process status. . 


eee 


ee es 
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lockf(3C) 
acctems(1M)} 
errdead(1M) 
fwtmp(1M) 
frec(1M) 
recv(2N) 
recy(2N) 
ed(1) 
regemp(3X) 
regemp(1) 
make(1) 
regemp(3X) 
regexp(5) 
locking(2) 
regexp(5) 
regemp(1) 
regemp(3X) 
accept(1M) 
comm(1) 
lorder(1) 
join(1) 
reloc(4) 
mktpy(1) 
Idrseek(3X) 
reloc(4) 
floor(3M) 
calendar(1) 
uux(1C) 
remd(3N) 
uuxqt(1M) 
rexec(3N) 
rhosts(4N) 
rexecd(1NM) 
rep(1N) 
rlogin(1N) 
rlogind(1NM) 
remd(1N) 
tshd(1NM) 
Uutry(1M) 
ct(1C) 
rmdel(1) 
iperm(1) 
unlink(2) 
dismount(1) 
rm(1) 
deroff(1) 
renice(1) 
fsck(1M) 
uniq(1) 
clock(3C) 
fsize(1) 
ipes(1) 
df(1M) 
errpt(1M) 
sar(1M) 
timex(1) 
ps(1) 


a file. uniq: 
sar: system activity 
fseek, rewind, ftell: 

move/ /start/stop the LP 
reject: allow/prevent LP 
scheduler and move 
syslocal: special system 
Ip, cancel: send/cancel 
execute remote command 
common/ ldgetname: 
value. abs: 

user. logname: 

remote command. rexec: 
environment/ getenv: 
call. stat: data 

/ruserok: routines for 
col: filter 

reposition a/ fseek, 
/create a new file or 

a remote command. 
server. 

equivalent users. 


server. 
or directories. 

users or read/ mail, 
from an SCCS file. 
directories. rm, 

chroot: change 
command. chroot: change 
/logarithm, power, square 
manipulate the routing/ 
/td: graphical device 
/rresvport, ruserok: 
address manipulation 
object file access 

compile and match 

table of contents 
manually manipulate the 
routines for/ rcemd, 
/terminal’s local 

tdl, gtdl, ptdi: 
standard/restricted/ sh, 
server. 

and stop terminal input/ 
priority. nice: 

hangups and/ nohup: 
runacct: 

accounting. 

/prdaily, prtacct, 

/alter priority of 

of nodes on local / 

remd, rresvport, 

on local network. 

server. 

activity report / 

activity report/ sal, 
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report repeated linesin  . 
reporter. 
reposition afile/ ...- 
request scheduler and .. 
requests. accept, . «2. » 
requests. /LP request .. 
requests. 
requests to an LP line/ . . 
requests, uuxqt: oe ee 
retrieve symbol name for . 
return integer absolute .. 
return login nameof ... 
return stream toa .... 
return value for ..... 
returned by stat system . 
returning a stream toa/ . 
reverse line-feeds. . 2... 
rewind, ftell: . 2.2... 
rewrite an existing one. . 
rexec: return stream to . . 
rexecd: remote execution . 
rhosts: remote 
rlogin: remote login. . .. 
rlogind: remote login . .. 
rm, rmdir: remove files . . 
rmail: send mailto ... 
rmdel: remove a delta . . 
rmdir: remove filesor . . 
root directory. ...e-. 
root directory fora ... 
root functions. 
route: manually 
routines and filters. . . . 
routines for returning a/ . 
routines. /Internet ... 
routines. ldfen: common . 
routines. /expression . . 
routines. /graphical . . - 
routing tables. route: .. 
rresyport, ruserok: .... 
RS-232 channels. ...- 
RS-232 terminal/ ... . 
rsh: shell, the . 2... se 
rshd: remote shell .. . « 
rsterm: manually start . . 
run acommand atlow .. 
run a command immune to 
run daily accounting. .. 
runacet: run daily .... 
runacct, shutacct,/ 2. . 
running process by/ ...- 
ruptime: display status . . 
ruserok: routines for/ . . 
rwho: who is logged in . . 
rwhod: node status ... 
sal, sa2, sade: system. « 
sa2, sade: system ...-. 
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uniq(1) 
sar(1) 
fseek(3S) 
Ipsched(1M) 
accept(1M) 
Ipsched(1M) 
syslocal(2) 
\p(2) 
uuxqt(1M) 
ldgetname(3X) 
abs(3C) 
logname(3X) 
rexec(3N) 
geteny(3C) 
stat(5) 
remd(3N) 
col(1) 
fseek(3S) 
creat(2) 
rexec(3N) 
rexecd(1NM) 
rhosts(4N) 
rlogin(1N) 
rlogind(1NM) 
rm(1) 
mail(1) 
rmdel(1) 
rm(1) 
chroot(2) 
chroot(1M) 
exp(3M) 
route(1NM) 
gdev(1G) 
remd(3N) 
inet(3N) 
ldfen(4) 
regexp(5)} 
toc(1G) 
route(1NM) 
remd(3N) 
tp(7) 

tdl({1) 

sh(1) 
rshd(1NM) 
rsterm(1M) 
nice(1) 
nohup(1) 
runacet(1M) 
runacct(1M) 
acctsh(1M) 
renice(1) 
ruptime(1N) 
remd(3N) 
rwho(1N) 
rwhod(1NM) 
sar(1M) 
sar(1M) 


file editing activity. 
report/ sal, sa2, 
profiler. 

graph. 

reporter. 

segment space/ brk, 
convert formatted/ 
bfs: big file 

language. awk: pattern 
delta commentary of an 
comb: combine 

a delta (change) to an 
sact: print current 

get: get a version of an 
prs: print an 

remove a delta from an 
two versions of an 
sccsfile: format of 

a previous get of an 
ya): validate 

create and administer 
what: identify 

versions of an SCCS/ 
file. 

/the LP request 
system. uusched: the 
for a common object / 
clear: clear terminal 
ocurse: optimized 
curses: CRT 

display editor/ vi: 
process. inittab: 

of terminal session. 
initialization shell 


difference program. 
grep, egrep, fgrep: 
bsearch: binary 
accounting/ acctcom: 
Isearch, Ifind: linear 
hdestroy: manage hash 
twalk: manage binary 
common object/ senhdr: 
/read an indexed/named 
line number entries of a 
relocation entries of a 
/to an indexed /named 
object/ size: print 


/jrand48, srand48, 
Idsseek, ldnsseek: 
Idiseek, Idnlseek: 
Idrseek, ldnrseek: 

file header/ Idohseek: 
of acommon/ Idtbseek: 
get shared memory 

brk, sbrk: change data 
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sact: print current SCCS . . sact(1) 
sade: system activity . . . . sar(1M) 
sadp: disk access ... . . sadp(1M) 
sag: system activity . . . . sag(1G) 
sar: system activity... . sar(1) 
sbrk: change data .... . brk(2) 
scanf, fscanf, sscanf: . . . . scanf(3S) 
scanner. 2. ee eee eee bfs(1) 
scanning and processing . . awk(1) 
SCCS delta. /change the . ede(1) 
SCCS deltas. . 2.2... es comb(1) 
SCCS file. delta: make . delta(1) 
SCCS file editing/ ..-... sact(1) 
SCCS file «2.2.2... get(1) 
SCCS file 2... . prs(1) 
SCCS file. rmdel: . . .. « rmdel(1) 
SCCS file. /compare . scesdiff(1) 
SCCS file ...2..2-..- secsfile(4) 
SCCS file. unget: undo. . unget({1) 
SCCS file 2.2... eae val(1) 
SCCS files. admin: . . . . admin(1) 
SCCS files. 2. 2-2 . what(1) 
scesdiff: compare two . . . sccsdiff(1) 
secsfile: format of SCCS . sccsfile(4) 
scheduler and move/ . . . . Ipsched(1M) 
scheduler for the UUCP_ . . uusched(1M) 
senhdr: section header . . . scnhdr(4) 
screen, « 6 « « «© © © © © « Clear(1) 
screen functions. «+... . ocurse(3X) 
screen handling and/ . . - curses(3X) 
screen-oriented (visual) . . . vi(1) 
script for the init .. .. . inittab(4) 
script: make typescript . . . script(1) 
scripts. /system .. .. + bre(1M) 
sdb: symbolic debugger. . . sdb(1) 
sdiff: side-by-side .. . . . sdiff(1) 
search afile fora/ .... . grep(1) 


search a sorted table. 
search and print process 
search and update. 
search tables. /hcreate, 
search trees. /tdelete, 
section header for a 
section header of a/ 
section of acommon/ /to . 
section of a common/ /to 
section of a common/ 
section sizes of common 
sed: stream editor. ..... 
seed48, Ilcong48:/ ..-... 
seek to an/ 
seek to line number/ . ... 
seek to relocation/ ..... 
seek to the optional ... 
seek to the symbol table 
segment. shmget: 
segment space/ 
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- bsearch(3C) 
- acctcom(1) 
- lsearch(3C) 
- hsearch(3C) 
« « tsearch(3C) 
- « senhdr(4) 


Idshread(3X) 
Idlseek(3X) 


. Idrseek(3X) 
. Idsseek(3X) 
- size(1) 


sed(1) 
drand48(3C) 
Idsseek(3X) 
Idlseek(3X) 
Idrseek(3X) 


- Idohseek(3X) 
. ldtbseek(3X) 
. shmget(2) 


brk(2) 


common to two/ comm: 
greek: 

line of a/ cut: cut out 
object file. dump: dump 
operations. semctl: 
semop: 

/remove a message queue, 
semget: get set of 
control operations. 
semaphores. 

operations. 

socket. send, sendto: 
process or a/ kill: 

read mail. mail, rmail: 
message to a socket. 

an LP line/ Ip, cancel: 
to a socket. send, 
/attach and detach 

File Transfer Protocol 
rexecd: remote execution 
rlogind: remote login 
rshd: remote shell 
rwhod: node status 
DARPA TELNET protocol 
File Transfer Protoco) 
uucpd: network uucp 
typescript of terminal 
Internet address from/ 
buffering to a stream. 
address on disk. 

group IDs. setuid, 
/getgrgid, getgrnam, 
get/ /gethostbyname, 
non-local goto. 

generate hashing/ crypt, 
table. 

get/ /getnetbyname, 
group ID. 
/getprotobyname, 
/getpwuid, getpwnam, 
get/ /getservbyname, 
options on/ getsockopt, 
environment/ cprofile: 
environment at/ profile: 
/speed and terminal 

and group IDs. 

system. 

/getutline, pututline, 
buffering to a/ setbuf, 
integer data in/ sputl, 
standard/restricted/ 
xstr: extract and 
operations. shmctl: 
/queue, semaphore set or 
operations. shmop: 
shmget: get 

remd: remote 
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select cr reject lines . . 
select terminal filter. . . 
selected fields of each. 
selected parts ofan .. 
semaphore control .. . 
semaphore operations. . 
semaphore set or shared/ 
semaphores. .. 2... 
semctl: semaphore .. . 
semget: get seLof ... 
semop: semaphore .. . 
send a messagetoa .. 
send asignaltoa ... 
send mail to usersor . . 
send, sendto: senda .. 
send/cancel requests to 
sendto: send a message . 
serial lines as network / 
server. /DARPA Internet 
server. 
server. 
server. 
server. 2 ee we wee 
server. telnetd: . 2. « 
server. /DARPA Trivial 
server. 
session. script: make. 
setaddr: set DARPA . . 
setbuf, setvbuf: assign . 
setenet: write Ethernet . 
setgid: set user and .. 
setgrent, endgrent,/ . . 
sethostent, endhostent: . 
setjmp, longjmp: ...- 
setkey, encrypt: 
setmnt: establish mount 
setnetent, endnetent: . 
setpgrp: set process . » 
setprotoent,/ ....- 
setpwent, endpwent,/ . 
setservent, endservent: . 
setsockopt: get and set . 
setting up aC shell .. 
setting up an 2. ee es 
settings used by getty. . 
setuid, setgid: set user . 
setuname: set name of . 
setutent, endutent,/ . . 
setvbuf: assign ... 
sgetl: access long ... 
sh, rsh: shell, the ... 
share stringsinC/  .. 
shared memory control . 
shared memory id... - 
shared memory 
shared memory segment. 
shell command execution. 
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comm(1) 
greek(1) 
ceut(1) 
dump(1) 
semcti(2) 
semop(2) 
iperm(1) 
semget(2) 
semcetl(2) 
semget(2) 
semop(2) 


slattach(1NM) 
ftpd(1NM) 
rexeed(1NM) 
rlogind(1NM) 
rshd(INM) 
rwhod(1NM) 
telnetd(1NM) 
tftpd{1NM) 
uucpd(1NM) 
script(1) 
setaddr(1NM) 
setbuf(3S) 
setenet(1NM) 
setuid(2) 
getgrent(3C) 
gethostent(3N) 
setjmp(3C) 

ery pt(3C) 
setmnt(1M) 
getnetent(3N) 
setpgrp(2) 
getprotoent(3N) 
getpwent(3C) 
getservent(3N) 
getsockopt(2N) 
cprofile(4) 
profile(4) 
gettydefs(4) 
setuid(2) 
setuname(1M) 
getut(3C) 
setbuf(3S) 
sputl(3X) 
sh(1) 

xstr(1) 
shmctl(2) 
iperm(1) 
shmop(2) 
shmget(2) 
remd(1N) 


interpreter)/ esh: a 
system: issue a 

cprofile: setting up a C 
shl: 

/startup, turnacct: 
system initialization 
rshd: remote 

sh, rsh: 

manager. 

control operations. 
memory segment. 
operations. 
full-duplex/ shutdown: 
/prtacct, runacct, 
terminate all/ 

of a full-duplex/ 
program. sdiff: 

login: 

suspend process until 
to do upon receipt of a 
do upon receipt of a/ 
group of/ kill: send a 
gsignal: software 
/generate programs for 
generator. rand, srand: 
acos, atan, atan2:/ 
hyperbolic functions. 
fsize: report file 

sizes of common object / 
size: print section 
attach and detach/ 
detach serial/ slattach, 
for an interval. 

for interval. 

view graphs, and 

view graphs and 

the/ ttyslot: find the 
spline: interpolate 
accept a connection on a 
bind: bind a name toa 
a connection on a 
endpoint for/ 

for connections on a 
getsockname: get 
receive a message from a 
send a message toa 
get and set options on 
/file perusal filter for 
ctinstall: install 

ssignal, gsignal: 

/install and verify 

sort: 

qsort: quicker 

files. 

tsort: topological 

lines common to two 
bsearch: binary search a 
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shell (command .... 
shellcommand. .... 
shell environment at/ . 
shell layer manager. . . 
shell procedures for/ . . 
shell scripts. /drvload: . 
shell server. 
shell, the/ ....-- 
shi: shell layer 
shmctl: shared memory 

shmget: get shared .. 
shmop: shared memory . 
shut down partofa .. 
shutacct, startup,/ . . 
shutdown, halt: 


shutdown: shut down part 


side-by-side difference . 
sign on. 
signal, pause: . 2... 
signal. /specify what . 
signal: specify what to . 
signal to a process ora . 
signals. ssignal, 
simple lexical tasks. . . 
simple random-number . 
sin, cos, tan, asin, .. . 
sinh, cosh, tanh: ... 
size. » «eee ee ee 
size: print section .. . 
sizes of common object 

slattach, sldetach: 

sldetach: attach and 
sleep: suspend execution 
sleep: suspend execution 
slides. /documents, 
slides. /for typesetting . 
slot in the utmp file of . 
smooth curve. 
socket. accept: 
socket. . 2. ee ee ee 
socket. /initiate ... 
socket: create an . .. 
socket. listen: listen . . 
socket name. 
socket. recv, recvfrom: . 
socket. send, sendto: . 
sockets. /setsockopt: . 
soft-copy terminals. .. 
software. 
software signals. 
software using the/ . . 
sort and/or merge files. 

Sort. « 6 6 ea ee we 
sort: sort and/or merge 

sort. 2 6 « ee ee ee 
sorted files. /or reject . 
sorted table. 


oe 
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esh(1) 
system(3S) 
eprofile(4) 
shl(1) 
acctsh(1M) 
bre(1M) 
rshd(1NM) 
sh(1) 

shl(1) 
shmetl(2) 
shmget(2) 
shmop(2) 
shutdown(2N) 
acctsh(1M) 
shutdown(1M) 
shutdown(2N 
sdiff(1) 
login(1) 
pause(2) 
signal(2) 
signal(2) 
kill(2) 
ssignal(3C) 
lex(1) 
rand(3C) 
trig(3M) 
sinh(3M) 
fsize(1) 

size(1) 

size(1) 
slattach(1NM) 
slattach(1NM) 
sleep(1) 
sleep(3C) 
mmt(1) 

my(5) 
ttyslot(3C) 
spline(1G) 
accept(2N) 
bind(2N) 
connect(2N) 
socket(2N) 
listen(2N) 
getsockname(2N) 
recv(2N) 
send(2N) 
getsockopt(2N) 
pg(1) 
ctinstall(1) 


« ssignal(3C) 


qinstall(1) 
sort(1) 
qsort(3C) 
sort(1) 
tsort(1) 
comm(1) 
bsearch(3C) 


change data segment 
/unexpand: expand tabs to 
terminal. ct: 

files. fspec: format 
openi: open a file 
receipt of a/ signal: 
terminal type, modes, 
terminal type, modes, 
settings/ gettydefs: 
spellin, hashcheck:/ 
spell, hashmake, 
/spellin, hashcheck: find 
smooth curve. 

pieces. split: 

esplit: context 

or efl files. fsplit: 
pieces. 

uucleanup: uucp 

Ipr: line printer 
/configure the LP 
printf, fprintf, 

long integer data in a/ 
exp, log, log10, pow, 
/ogarithm, power, 
random-number/ rand, 
/mrand48, jrand48, 
seanf, fscanf, 

software signals. 
input/output/ stdio: 
communication/ ftok: 
sh, rsh: shell, the 
input/ rsterm: manually 
Ipsched, Ipshut, Ipmove: 
/runacct, shutacct, 

stat system call. 

status. 

network useful with/ 
stat: data returned by 
useful with/ stat: 

/list file names and 
ustat: get file system 
dump. /error records and 
Ipstat: print LP 
clearerr, fileno: stream 
control. uustat: uucp 
communication facilities 
netstat: show network 
ruptime: display 

ps: report process 
rwhod: node 

stat, fstat: get file 
input/output package. 


for child process to 
/manually start and 
strnemp, strepy,/ 
/strepy, strnepy, strlen, 
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space allocation. /sbrk: 

spaces, and vice versa. . 
spawn getty to a remote 
specification in text . . 
specified by i-node. 
specify what to do upon 
speed, and line/ /set . 
speed, and line/ /set . 
speed and terminal .. 
spell, hashmake, .... 
spellin, hashcheck: find/ 
spelling errors. 

spline: interpolate 
split afileinto .... 
Spliti..o 8 c6 wee fee Be 
split FORTRAN, ratfor, 
split: split a file into . . 
spool directory/ .... 
spooler, ....ee- 
spooling system. ... « 
sprintf: print formatted / 
sputl, sgetl: access . . . 
sqrt: exponential,/ ... 
square root functions. . 
srand: simple ..... 
srand48, seed48,/ ... 
sscanf: convert/ .... 
ssignal, gsignal: .... 
standard buffered ... 
standard interprocess . 
standard/restricted/ . . 
start and stop terminal 

start/stop the LP/ . . 
startup, turnacct: shell/ 
stat: data returned by . 
stat, fstat: get file .. . 
stat: statistical 2... 
stat system call. . 2... 
statistical network ... 
statistics for afile/  . . 
statistics. . 2. 2. 2 6 ee 
status information from 
status information. .. 
status inquiries. /feof, . 
status inquiry and job . 
status. /inter-process . 
status. 
status of nodes on local/ 
Status. 2 2. « +» «© « oe « 
status server. 
status. 
stdio: standard buffered 
stime: set time. 
stop or terminate. /wait 
stop terminal input and/ 
strceat, strncat, stremp, . 
strehr, strrchr,/ 2... . 
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brk(2) 
expand(1)} 
et(1C) 
fspec(4) 
openi(2) 
signal(2) 
getty(1M) 
wugetty(1M)} 
getty defs(4) 
spell(1) 
spell(1) 
spell(1) 
spline(1G) 
split(1) 
esplit(1) 
fsplit(1) 
split(1) 
uucleanup(1M) 
Ipr(1) 
Ipadmin(1M) 
printf(3S) 
sputl(3X) 
exp(3M) 
exp(3M) 
rand(3C) 
drand48(3C) 
scanf(3S) 
ssignal(3C) 
stdio(3S) 
stdipe(3C) 
sh(1) 
rsterm(1M) 
Ipsched(1M)} 
acctsh(1M) 
stat(5) 
stat(2) 
stat(1G) 
stat(5) 
stat(1G) 
ff(1M) 
ustat(2) 
errdead(1M) 
Ipstat(1) 
ferror(3S) 
uustat(1C) 
ipes(1)} 
netstat(1N) 
ruptime(1N) 


» ps(1) 


rwhod(1NM) 
stat(2) 
stdio(3S) 
stime(2) 
wait(2) 
rsterm(1M) 
string(3C) 
string(3C) 


streat, strncat, 

/stremp, strnemp, 
/strpbrk, strspn, 

sed: 

fflush: close or flush a 
freopen, fdopen: open a 
a file pointer in a 
character or word from a 
get astring froma 
character or word on a 
fputs: put a string on a 
assign buffering to a 
/feof, clearerr, fileno: 
/routines for returning a 
command. rexec: return 
back into input 

and base-64 ASCII 
convert date and time to 
floating-point number to 
gps: graphical primitive 
gets, fgets: get a 

puts, fputs: put a 
/strspn, strespn, strtok: 
strtod, atof: convert 
atof: convert ASCII 
/atol, atoi: convert 
ASCII text strings in a/ 
/extract the ASCII text 
xstr: extract and share 
line number information/ 
number/ strip: 

/strepy, strnepy, 
strnemp,/ strcat, 
Streat, strncat, strcmp, 
/stremp, strnemp, strepy, 
/strlen, strehr, strrchr, 
/strnepy, strlen, strchr, 
/strrehr, strpbrk, 

string to/ 

strspn, strespn, 

convert string to/ 

using a file or file 

for a terminal. 

another user. 

intro: introduction to 
plot: graphics interface 
/of several files or 

block count of a file. 

du: 

acctcms: command 
sync: update the 

sync: update 

user. su: become 
interval. sleep: 

interval. sleep: 

signal. pause: 
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stremp, strnemp, strepy,/ 

strepy, strncpy, strlen,/ . 
strespn, strtok: string/ . . 
stream editor. .....-. 


stream. fclose, ..... 
stream. fopen, ....-. 
stream. /reposition .. . 
stream. /getw: get ... 
stream. gets, fgets: ... 
stream. /putw: put ... 
stream. puts, .....e.-. 
stream. /setvbuf: .... 


stream status inquiries. . 
stream toaremote/ ... 
stream to a remote 
stream. /push character . 
string. /long integer . . . 
string. /asctime, tzset: . . 
string. /gcvt: convert . . 
string, format off .... 
string fromastream. .. 
string on astream. ... 
string operations. .... 
string to/ 
string to floating-point/ . 
string to integer. ... 
strings: extract the ... 
strings in a file. 
strings in C programs. . . 
strip: strip symbol and . . 
strip symbol and line. . 
strlen, strehr, strrehr,/ . . 
strncat, strcmp, 
strnemp, strepy,/ . +... 
strncpy, strlen, strchr,/- 
strpbrk, strspn,/ ...- 
strrchr, strpbrk,/ .. + 
strspn, strespn, strtok:/ . 
strtod, atof: convert ... 
strtok: string/ /strpbrk, . 
strtol, atol, atoi: ..... 
structure. /processes . . 
stty: set the options ... 
su: become super-user or . 
subroutines and/ ...- 
subroutines. 
subsequent lines of one/_ . 
sum: print checksum and . 
summarize disk usage. . . 
summary from per-process/ 
super block. 
super-block. 
super-user or another .. 
suspend execution for an . 
suspend execution for .. 
suspend process until . . 
swab: swap bytes. .... 


ee e we ee 


ee © oe 


oe we we we 
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sed(1) 
fclose(3S) 
fopen(3S) 
fseek(3S) 
getc(3S) 
gets(3S) 
putc(3S) 
puts(3S) 
setbuf(3S) 
ferror(3S) 
remd(3N) 
rexec(3N) 
unget¢(3S) 
a641(3C) 
ctime(3C) 
ecvt(3C) 
gps(4) 
gets(3S) 
puts(3S) 
string(3C) 
strtod(3C) 
atof(3C) 
strtol(3C) 
strings(1) 
strings(1) 
xstr(1) 


strtod(3C) 
string(3C) 
strtol(3C) 
fuser(1M) 
stty(1) 
su(1) 
intro(3) 
plot(3X) 
paste(1) 
sum(1) 
du(1)} 
acctcms(1M) 
syne(1) 
syne(2) 
su(1) 
sleep(1) 
sleep(3C) 
pause(2) 
swab(3C) 


interface. swap: 

swab: 

administrative/ 

write on a file. 

driver. 

strip: strip 

Idgetname: retrieve 

/for common object file 
/compute the index of a 
common/ /read an indexed 
syms: common object file 
Idtbseek: seek to the 
sdb: 

symbol table format. 
super-block. 

block. 

update: provide disk 
file. swrite: 

interpreter) with C-like 
system/ perror, errno, 
requests. 

/errno, sys_errlist, 
binary search a sorted 
object file symbol 

/the index of a symbol 
/read an indexed symbol 
object file symbol 
device information 
mounted file system 
/seek to the symbol 
toc: graphical 

setmnt: establish mount 
troff. tbl: format 
manage hash search 
manipulate the routing 
tabs: set 

terminal. 

expand, unexpand: expand 
ctags: create a 

part of a file. 

atan2:/ sin, cos, 
functions. sinh, cosh, 
Xylogies 772 half-inch 
tar: 

files from a backup 

qic: interface for QIC 


for simple lexical 
/remove nroff/troff, 
nroff or troff. 

/erase, hardcopy, tekset, 
binary/ tsearch, tfind, 
terminal download. 


hpd, erase, hardcopy, 


4014: paginator for the 
initialization. init, 
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swap administrative ... 
swap bytes. 
swap: swap 
swrite: synchronous .. . 
sxt: pseudo-device 
symbol and line number/ . 
symbol name for common/ 
symbol table entry. ... 
symbol table entry of a/ . 
symbol table entry ofa . 
symbol table format. . . . 
symbol table of a common/ 
symbolic debugger. 
syms: common object file . 
sync: update 
sync: update the super .. 
synchronization. 
synchronous writeona . 
syntax. /shell (command . 


sys_errlist, sys_nerr: .... 


syslocal: special system . . 
sys_nerr: system error/ . .- 
table. bsearch: 
table entry. /for common 
table entry of a common/ 
table entry of a common/ 
table format. /common . 
table. master: master 
table. mnttab: 
table of a common object/ 
table of contents/ 
table. 
tables for nroff or 
tables. /hdestroy: 
tables. route: manually 
tabs on aterminal. .. . 
tabs: set tabsona.... 
tabs to spaces, and vice/ . 
tags file. 
tail: deliver the last ... 
tan, asin, acos, atan, . . . 
tanh: hyperbolic ..... 
tape controller. /for .. . 
tape file archiver. . 2... 
tape. frec: recover... - 
tape. 
tar: tape file archiver. . . 
tasks. /programs 
tbl, and eqn constructs. . 
tbl: format tables for .. 
td: graphical device/ . . . 
tdelete, twalk: manage .. 
tdl, gtdl, ptdl: RS-232 .. 
tee: pipe fitting. ..... 
tekset, td: graphical/. 
TEKTRONIX 4014 beeminal: 
telinit: process control 


. 
oe ee 
ee ee 

. 
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swap(1M) 
swab(3C) 
swap(1M) 
swrite(2) 
sxt(7) 
strip(1) 
ldgetname(3X} 
ldgetname(3X) 
\dtbindex(3X) 
Idtbread(3X) 
syms(4) 
Idtbseek(3X) 
sdb(1) 
syms(4) 
syne(2) 
sync(1) 
update(1M) 
swrite(2) 
cesh(1) 
perror(3C) 
syslocal(2) 
perror(3C) 
bsearch(3C) 
Idgetname(3X) 
ldtbindex(3X) 
Idtbread(3X) 
syms(4) 
master(4) 
mnttab(4) 
Idt bseek(3X) 
toc(1G) 
setmnt(1M) 
tbl(1) 
hsearch(3C) 
route(1NM) 
tabs(1) 
tabs(1) 
expand(1) 
ctags(1) 
tail(1) 
trig(3M) 
sinh(3M) 
xmset(1M) 
tar(1) 
frec(1M) 
gic(7) 

tar(1) 

lex(1) 
deroff(1) 
tbl(1) 
gdev(1G) 
tsearch(3C) 
tdl(1) 


telnetd: DARPA 

/user interface to 

to TELNET protocol. 
protocol server. 

for a temporary/ tmpnam, 
tmpfile: create a 

/create a name for a 

for terminals. 

term: format of compiled 
term file.. 

capability data base. 

for the TEKTRONIX 4014 
of the DASI 450 
interface. tiop: 

base. termcap: 

base. terminfo: 

console: console 

spawn getty to a remote 
generate file name for 
tdl, gtdl, ptdl: RS-232 
/terminal inteface, and 
greek: select 

/tgetstr, tgoto, tputs: 
/manually start and stop 
tset: set terminal, 
termio: general 

tty: controlling 

establish an out-going 

of terminal types by 
clear: clear 

/make typescript of 

by/ gettydefs: speed and 
set the options for a 
tabs: set tabs on a 
inteface, and/ tset: set 
conlocate: locate a 

tty: get the name of the 
isatty: find name of a 
speed, and/ getty: set 
speed, and/ uugetty: set 
ttytype: list of 

vt: virtual 

of DASI 300 and 300s 
HP 2640 and 2621-series 
tp: controlling 

filter for soft-copy 
conventional names for 
kill: 

shutdown, halt: 

exit, _exit: 

error-logging/ errstop: 
child process to stop or 
tic: 

tput: query 

capability data base. 
interface. 

evaluation command. 
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TELNET protocol server. 

TELNET protocol. ... 
telnet: user interface 
telnetd: DARPA TELNET 
tempnam: create a name . 
temporary file. 
temporary file. 
term: conventional names 
term file.. 
term: format of compiled . 
termcap: terminal 
terminal. /paginator .. 
terminal. /functions . . . 
terminal accelerator ... 
terminal capability data . 
terminal capability data . 
terminal. 
terminal. ct: 
terminal. ctermid: .... 
terminal download. ... 
terminal environment. . . 
terminal filter. 
terminal independent/ . . 
terminal input and/ ... 
terminal inteface, and/ . . 
terminal interface. 
terminal interface. ; 
terminal line/ dial: ... 
terminal number. /list . . 


eee 


terminal screen. 
terminal session. 
terminal settings used .. 
terminal. stty: 
terminal. 
terminal, terminal 
terminal to use as the/ . . 
terminal. 


ee ee 


eo 8 8 e © ew © 


oe ee 
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telnetd(1NM) 
telnet(1N) 
telnet(1N) 
telnetd(1NM) 
tmpnam(3S)} 
tmpfile(3S) 
tmpnam(3S) 
term(5) 
term(4) 
term(4) 
termcap(4) 
4014(1) 
450(1) 
tiop(7) 
termcap(4) 
terminfo(4) 
console(7) 
et(1C) 
ctermid(3S) 
tdl(1) 
tset(1) 
greek(1) 
termcap(3X) 
rsterm(1M) 
tset(1) 
termio(7) 


. tty(7) 


terminal. ttyname, .... 


terminal type, modes, .. 
terminal type, modes, .. 
terminal types by/ ... 
terminal. 
terminals. /functions .. 
terminals. /functions of . 
terminal’s local RS-232/ 

terminals. /file perusal . 
terminals. term: 
terminate a process. .. . 
terminate all/ ......- 
terminate process. . . . « 
terminate the 
terminate. /waitfor .. . 
terminfo compiler. .... 
terminfo database. .. .~ 
terminfo: terminal ... . 
termio: general terminal . 
test: condition 
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dial(3C) 
ttytype(4) 
clear(1) 
script(1) 

getty defs(4) 
stty(1) 
tabs(1) 
tset(1) 
conlocate(1M) 
tty(1) 
ttyname(3C) 
getty(1M) 
uugetty(1M) 
ttytype(4) 
vt(7) 

300(1) 

hp(1) 

tp(7) 
pa(1) 
term(5) 

kill(1) 
shutdown(1M) 
exit(2) 
errstop(1M) 
wait(2) 
tic(1M) 
tput(1) 
terminfo(4) 
termio(7) 


. test(1) 


quiz: 

ed, red: 

ex: 

ex for casual/ edit: 
change the format of a 
format specification in 
/format mathematical 
/prepare constant-width 
nroff: format 

plock: lock process, 
more, page: 

/extract the ASCII 
troff: typeset 

manage binary/ tsearch, 
interface to the DARPA 
the DARPA TFTP/ 
File Transfer Protocol/ 
tgetflag, tgetstr,/ 
tgetent, tgetnum, 
tgetstr,/ tgetent, 
/tgetnum, tgetflag, 
/tgetflag, tgetstr, 


ttt, cubic: 

process data and/ timex: 
time: 

commands at a later 
environment at login 

for optimal access 


profil: execution 
an environment at login 
stime: set 


time: get 

/tzset: convert date and 
clock: report CPU 

TZ: 

child process times. 
access and modification 
and child process 

access and modification 
report process data and/ 
accelerator interface. 
temporary file. 

a name for a temporary / 
/_toupper, _tolower, 
contents routines. 
/pclose: initiate pipe 
/tolower, _toupper, 
_tolower,/ toupper, 
tsort: 

acctmerg: merge or add 
modification times of a/ 
toupper, tolower, 
_toupper, _tolower,/ 
terminal’s local RS-232/ 
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test your knowledge. . . . 
text editor. 
text editor. 
text editor (variant of .. 
text file. newform: ... 
text files. fspec: . 2... 
text for nroff or troff. .. 
text for troff. 
text. 2. 2. se we we we wo oe 
text, or data in memory. . 
text perusal. . . 2.2. ee 
text strings inafile. ... 
GOXb. ae ee ee ke 
tfind, tdelete, twalk: ... 
TFTP protocol. /user . . 
tftp: user interface to .. 
tftpd: DARPA Trivial .. 
tgetent, tgetnum, ...- 
tgetflag, tgetstr,/ ...- 
tgetnum, tgetflag, .... 
tgetstr, tgoto, tputs:/  . . 
tgoto, tputs: terminal/ . . 
tic: terminfo compiler. . . 
tic-tac-toe. 2... «eee 
time a command; report . 
time a command. 
time. /batch: execute . . 
time. /upaC shell ... 
time. /copy file systems . 
time: get time. 
time profile. 

time. /setting up .... 
time. 
time: time a command. . . 
time. 
time to string. ... 
time used. 2. 2. 2. ee ee 
time zone file. . . 2.» 2 « 
times: get process and .. 
times of a file. /update . 
times. /get process .. - 
times. utime: set file ars 
timex: time acommand; . 
tiop: terminal 
tmpfile: createa . 2... 
tmpnam, tempnam: create 
toascii: translate/ ... . 
toc: graphical table of .. 
to/from a process. . . + 
_tolower, toascii:/ .. +. 
tolower, _toupper, . ... 
topological sort. 
total accounting files. .. 
touch: update access and . 
_toupper, _tolower,/ .. . 
toupper, tolower, 
tp: controlling 


es © © © © we ee 


Cr 
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quiz(6) 
ed(1) 

ex(1) 
edit(1) 
newform(1) 
fspec(4) 
eqn(1) 
cw(1) 
nroff(1) 
plock(2) 
more(1) 
strings(1) 
troff(1) 
tsearch(3C) 
tftp(1N) 
tftp(1N) 
t{tpd(1NM) 
termcap(3X) 
termcap(3X) 
termeap(3X) 
termcap(3X) 
termcap(3X) 
tic(1M) 
ttt(6) 
timex(1) 
time(1) 
at(1) 
eprofile(4) 
dcopy(1M) 
time(2) 
profil(2) 
profile(4) 
stime(2) 
time(1) 


tiop(7) 
tmpfile(3S) 
tmpnam(3S) 
cony(3C) 
toc(1G) 
popen(3S) 
conv(3C) 
conv(3C) 
tsort(1) 
acctmerg(1M) 
touch(1) 
conv(3C) 
conv(3C) 
tp(7) 


database. 

/tgetstr, tgoto, 
characters. 

ptrace: process 

trpt: print protocol 

ftp: file 

DARPA Internet File 
/DARPA Trivial File 
/_tolower, toascii: 

tr: 

ftw: walk a file 

manage binary search 
trk: 

/asin, acos, atan, atan2: 
Protocol/ tftpd: DARPA 


constant-width text for 
text for nroff or 
typesetting view/ mv: a 
tables for nroff or 


trace. 

truth values. 

/u3b, u3b5, vax: provide 
true, false: provide 
system with/ Uutry: 
twalk: manage binary / 
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terminal interface. 
terminal. 

name of a terminal. 

in the utmp file of the/ 
terminal types by/ 

/a loadable driver for 
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translate characters. . . 
tree. 
trees. /tdelete, twalk: . 
trekkie game. . 2.2... 
trigonometric functions. 
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current CTIX system. 
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get of an SCCS file. 
back into input stream. 
/lcong48: generate 
lines in a file. 

mktemp: make a 
program. 

and unlink system/ link, 
entry. 
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umount: 

expand/ pack, pcat, 
modification/ touch: 
groups/ make: maintain, 
Ifind: linear search and 
synchronization. 

syne: 

syne: 

du: summarize disk 
/statistical network 
names. id: print 
setuid, setgid: set 
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real/ /getegid: get real 
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protocol. telnet: 
DARPA TFTP/ tftp: 
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wall: write to all 
/identify processes 
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and modification times. 
formats. utmp, wtmp: 
/utmpname: access 
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wtmp entry formats. 
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using the mkfs(1) proto/ . 
ustat: get file system ... 
utilities, . 2. 2. ee wee 
utime: set file access . . . 
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letter from argument 
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ve: 

get: get a 

secsdiff: compare two 
print/ vprintf, 
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vme: 


file systems with label/ 
libdev: manipulate 
initialize and maintain 
vsprintf: print/ 
yprintf, vfprintf, 


of process. 

to stop or/ wait: 
process to stop or/ 
ftw: 

users. 


files. 

of a/ signal: specify 
whodo: 

local network. rwho: 
who: 

system. 

what. 

/long lines for finite 
primitives. window: 
wm: 

management primitives. 


cd: change 

chdir: change 

/get path-name of current 
pwd: 

on disk. setenet: 

swrite: synchronous 

write: 

entry. putpwent: 

wall: 

write: 


user. 
open for reading or 
utmp, wtmp: utmp and 
entry formats. utmp, 
connect/ fwtmp, 
hunt-the-wumpus. 
argument list(s) and/ 
parameters for Xylogics/ 
strings in C programs. 
/set drive parameters for 
functions. jO, jl, jn, 

JO, jl, jn, yO, 
compiler-compiler. 

jo, jl, jn, yO, yl, 

TZ: time 
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VME bus interface. . .. - 
vme: VME bus interface. . . 
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vt: virtual terminal. . ... 


wait: await completion ... 
wait for child process 
wait: wait for child 
walk afile tree. . . 
wall: write to all. 
we: word count. .. 
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who is doing what. .... 


who is logged inon ...- 
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working directory. . 2... 
working directory. 
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Xylogics 772 half-inch/ .. - 
yO, yl, yn: Bessel 
yl, yn: Bessel/ 
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yn: Bessel functions. . .. . 
zone file. 
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NAME 
intro — introduction to system calls and error numbers 


—_—_ SYNOPSIS 
#include <errno.h> 


DESCRIPTION 
This section describes all of the system calls. 


System call entries that are suffixed by (2N) are part of 
the CTIX networking packages. The link editor searches 
these calls under the —1 socket option. To use these 
calls you must have the network protocols on your 
system. See the CTIX Internetworking Manual for 
further information. 


Most of these calls have one or more error returns. An 
error condition is indicated by an otherwise impossible 
returned value. This is almost always —1; the individual 
descriptions specify the details. An error number is also 
made available in the external variable errno. Errno is 
not cleared on successful calls, so it should be tested only 
after an error has been indicated. 


Each system call description attempts to list all possible 


jis error numbers. The following is a complete list of the 
error numbers and their names as_ defined in 
<errno.h>. 


1 EPERM Not super-user 
Typically this error indicates an attempt to 
modify a file in some way forbidden except to its 
owner or super-user. It is also returned for 
attempts by ordinary users to do things allowed 
only to the super-user. 


ENOENT No such file or directory 
This error occurs when a file name or IPC 
identifier is specified and the file or IPC 
structure should exist but doesn’t, or when one 
of the directories in a path name does not exist. 


3 ESRCH No such process 
No process can be found corresponding to that 
specified by pid in kill or ptrace. 


4 EINTR Interrupted system call 
An asynchronous signal (such as interrupt or 
ian quit), which the user has elected to catch, 
occurred during a system call. If execution is 
resumed after processing the signal, it will 
appear as if the interrupted system call returned 
this error condition. 
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5 EIO I/O error 
ome physical I/O error has occurred. This 
error may in some cases occur on a call following 
the one to which it actually applies. 


6 ENXIO No such device or address 

I/O on a special file refers to a subdevice which 
oes not exist, or beyond the limits of the 
device. It may also occur when, for example, a 
tape drive is not on-line or no disk pack is 
loaded on a drive. On local terminals, it may 
indicate that the host terminal lacks the 
specified channel; for example, opening tpa256, 
when tty256 refers to a Programmable Terminal, 
not a Graphics Terminal. 


7 E2BIG Arg hist too long 
An argument list longer than 10,240 bytes is 
presented to a member of the ezec family. 


8 ENOEXEC Exec format error 
A request is made to execute a file which, 
although it has the appropriate permissions, does 
not start with a valid magic number (see 
a.out(4)), or the executable file requires 
hardware that does not exist (e.g., floating- 
point). 

9 EBADF Bad file number 
Either a file descriptor refers to no open file, or a 
read (respectively, write) request is made to a 
file which is open only for writing (respectively, 
reading). 


10 ECHILD No child processes 
A watt was executed by a process that had no 
existing or unwaited-for child processes. 


11 EAGAIN No more processes 
A fork failed because the system’s process table 
is full or the user is not allowed to create any 
more processes, or an IPC call is made with the 
IPC_NOWAIT option and the caller would 
block. 


12 ENOMEM Not enough space 
During an ezec, brk, or sbrk, a program asks for 
more space than the system is able to supply. 


13 EACCES Permission denied 
An attempt was made to access a file or IPC 
structure in a way forbidden by the protection 
system. From locking, an attempt to lock bytes 
already under a checking lock. 
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EFAULT Bad address 
The system encountered a hardware fault in 
attempting to use an argument of a system call. 


ENOTBLK Block device required 
A non-block file was mentioned where a block 
device was required, e.g., in mount. 


EBUSY Device or resource busy 

An attempt was made to mount a device that 
was already mounted or an attempt was made to 
dismount a device on which there is an active 
file (open file, current directory, mounted-on file, 
active text segment). It will also occur if an 
attempt is made to enable accounting when it is 
already enabled. The device or resource is 
currently unavailable. 


EEXIST File exists 
An existing file or IPC structure was mentioned 
in an inappropriate context, e.g., link. 


EXDEV Cross-device link 
A link to a file on another device was attempted. 


ENODEV No such device 
An attempt was made to apply an inappropriate 
system call to a device; e.g., read a write-only 
device. 


ENOTDIR Not a directory 
A non-directory was specified where a directory 
is required, for example in a path prefix or as an 
argument to chdir(2). 


EISDIR Is a directory 
An attempt was made to write on a directory. 


EINVAL Invalid argument 
Some invalid argument (e.g., dismounting a 
non-mounted device; mentioning an undefined 
signal in stgnal, or kill; reading or writing a file 
for which Iseek has generated a_ negative 
pointer). Also set by the math functions 
described in the (3M) entries of this manual. 


ENFILE File table overflow 


The system file table is full, and temporarily no 
more opens can be accepted. 


EMFILE Too many open files 
No process may have more than 20 file 
descriptors open at a time. When a record lock 
is being created with fentl, there are too many 
files with record locks on them. 
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ENOTTY Not a character device 
An attempt was made to tocti(2) a file that is 
not a special character device. 


ETXTBSY Text file busy 
An attempt was made to execute a pure- 
procedure program that is currently open for 
writing. Also an attempt to open for writing a 
pure-procedure program that is being executed. 


EFBIG File too large 
The size of a file exceeded the maximum file size 
(1,082,201,088 bytes) or ULIMIT; see ultmit(2). 


ENOSPC No space left on device 
During a wrtte to an ordinary file, there is no 
free space left on the device. In fentl, the setting 
or removing of record locks on a file cannot be 
accomplished because there are no more record 
entries left on the system. In an IPC call, no 
IPC identifiers are available. 


ESPIPE Illegal seek 
An lseek was issued to a pipe. 


EROFS Read-only file system 
An attempt to modify a file or directory was 
made on a device mounted read-only. 


EMLINK Too many links 
An attempt to make more than the maximum 
number of links (1000) to a file. 


EPIPE Broken pipe 
A write on a pipe for which there is no process 
to read the data. This condition normally 
generates a signal; the error is returned if the 
signal is ignored. 


EDOM Math argument 


The argument of a function in the math package 
(3M) is out of the domain of the function. 


ERANGE Result too large 
The value of a function in the math package 
(3M) is not representable within machine 
precision. 


ENOMSG No message of desired type 
An attempt was made to receive a message of a 
type that does not exist on the specified message 
queue; see msgop(2). 

EIDRM Identifier Removed 
This error is returned to processes that resume 
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execution due to the removal of an identifier 


from the file system’s name space (see msgcil(2), 
semcetl(2), and shmetl(2)). 


ECHRNG Channel number out of range 
Not used; retained for compatibility. 


EL2NSYNC Level 2 not synchronized 
Not used; retained for compatibility. 


EL3HALT Level 3 halted 
Not used; retained for compatibility. 


EL3RST Level 3 reset 
Not used; retained for compatibility. 


ELNRNG Link number out of range 
Not used; retained for compatability. 


EVNATCH Protocol driver not attached 
Not used; retained for compatibility. 


ENOCSI No CSI structure available 
Not used; retained for compatibility. 


EL2HLT Level 2 halted 
Not used; retained for compatibility. 


EDEADLK Record locking deadlock 
Call cannot be honored because of a potential 
deadlock. See fentl(2). 


ENOLCK No record locks available 
No free entries are currently available in the 
kernel lock array. 


EBADE Invalid exchange 
A user-specified exchange descriptor is out of 
range or specifies an unallocated exchange. 


EBADR Invalid request descriptor 
An attempt has been made to reference a request 
that is not outstanding. 


EXFULL Exchange full 
No request descriptors are currently available for 
this exchange. 


ENOANO No anode 
Not used; retained for compatibility. 


EBADRQC Invalid request code 
No routing is currently available for this request 
code. 


EBADSLT Invalid slot 
Not used; retained for compatibility. 
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56 EDEADLOCK Deadlock error 
Call cannot be honored because of potential 
deadlock or because lock table is full. See 
locking (2). 

57 EBFONT Bad font file format 
Not used; retained for compattbility. 


224 ENOHDW No hardware available for operation 
The address specification exceeds the allowable 
limits or the required hardware does not exist. 
See ezec(2). 


225 EBADFS Bit-mapped file system is marked dirty 
An attempt to mount a bit-mapped file system 
failed due to the dirty flag being set for that file 
system. 


226 EWOULDBLOCK Operation would block 
An operation which would cause a process to 
block was attempted on a object in non-blocking 
mode. 


227 EINPROGRESS Operation now in progress 
An operation which takes a long time to 
complete (such as a connect(2N)) was attempted 
on a non-blocking object. 


228 EALREADY Operation already in progress 
An operation was attempted on a non-blocking 
object which already had an operation in 
progress. 


229 ENOTSOCK Socket operation on non-socket 
Self-explanatory. 

230 EDESTADDRREQ Destination address required 
A required address was omitted from an 
operation on a socket. 


231 EMSGSIZE Message too long 
A message sent on a socket was larger than the 
internal message buffer. 

232 EPROTOTYPE Protocol wrong type for socket 
A protocol was specified which does not support 
the semantics of the socket type requested. For 
example, you cannot use the ARPA Internet 
UDP protocol with type SOCK_STREAM. 


233 EPROTONOSUPPORT Protocol not supported 
The protocol has not been configured into the 
system or no implementation for it exists. 


234 ESOCKTNOSUPPORT Socket type not supported 
The support for the socket type has not been 
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configured into the system or no implementation 
for it exists. 


EOPNOTSUPP Operation not supported on socket 
For example, trying to accept a connection on a 
datagram socket. 


EPFNOSUPPORT Protocol family not supported 
The protocol family has not been configured into 
the system or no implementation for it exists. 


EAFNOSUPPORT Address family not supported by 
protocol 
An address incompatible with the requested 
protocol was used. For example, you shouldn’t 
necessarily expect to be able to use PUP Internet 
addresses with ARPA Internet protocols. 


EADDRINUSE Address already in use 
Only one usage of each address is normally 
permitted. 


EADDRNOTAVAIL Can’t assign requested address 
Normally results from an attempt to create a 
socket with an address not on this machine. 


ENETDOWN Network is down 
A socket operation encountered a dead network. 


ENETUNREACH Network is unreachable 
A socket operation was attempted to an 
unreachable network. 


ENETRESET Network dropped connection on reset 
The host you were connected to crashed and 
rebooted. 


ECONNABORTED Software caused connection 
abort 
A connection abort was caused internal to your 
host machine. 


ECONNRESET Connection reset by peer 
A connection was forcibly closed by a peer. This 
normally results from the peer executing a 
shutdown (2) call. 


ENOBUFS No buffer space available 
An operation on a socket or pipe was not 


performed because the system lacked sufficient 
buffer space. 


EISCONN Socket is already connected 
A connect request was made on an already 
connected socket; or, a sendto or sendmsg 
request on a connected socket specified a 
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destination other than the connected party. 


247 ENOTCONN Socket is not connected 
An request to send or receive data was 
disallowed because the socket is not connected. 


248 ESHUTDOWN Can’t send after socket shutdown 
A request to send data was disallowed because 
the socket had already been shut down with a 
previous shutdown(2) call. 


249 ETOOMANYREFS Too many references: cant’ splice 


250 ETIMEDOUT Connection timed out 
A connect request failed because the connected 
party did not properly respond after a period of 
time. (The timeout period is dependent on the 
communication protocol.) 


251 ECONNREFUSED Connection refused 
No connection could be made because the target 
machine actively refused it. This usually results 
from trying to connect to a service which is 
inactive on the foreign host. 


252 EHOSTDOWN Host is down 
The host is down. 


253 EHOSTUNREACH No route to host 
The gateway does not recognize the requested 
host via the route specified. 


254 ENOPROTOOPT Protocol not available 
A bad option was specified in a getsockopt(2N) 
or setsockopt(2N) call. 
DEFINITIONS 
Process ID 
Each active process in the system is uniquely identified 


by a positive integer called a process ID. The range of 
this ID is from 1 to 30,000. 


Parent Process ID 
A new process is created by a currently active process; 
see fork(2). The parent process ID of a process is the 
process ID of its creator. 


Process Group ID 
Each active process is a member of a process group that 
is identified by a positive integer called the process 
group ID. This ID is the process ID of the group leader. 
This grouping permits the signaling of related processes; 
see kill(2). 
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Group ID 

Each active process can be a member of a terminal group 
that is identified by a positive integer called the tty 
group ID. This grouping is used to terminate a group of 
related processes upon termination of one of the 
processes in the group; see eztt(2) and signal(2). 


Real User ID and Real Group ID 


Each user allowed on the system is identified by a 
positive integer called a real user ID. 


Each user is also a member of a group. The group is 
identified by a positive integer called the real group ID. 


An active process has a real user ID and real group ID 
that are set to the real user ID and real group ID, 
respectively, of the user responsible for the creation of 
the process. 


Effective User ID and Effective Group ID 


An active process has an effective user ID and an 
effective group ID that are used to determine file access 
permissions (see below). The effective user ID and 
effective group ID are equal to the process’s real user ID 
and real group ID respectively, unless the process or one 
of its ancestors evolved from a process that had the set- 
user-ID bit or set-group ID bit set; see exec(2). 


Super-user 


A process is recognized as a super-user process and is 
granted special privileges if its effective user ID is 0. 


Special Processes 


File 


File 
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The processes with a process ID of 0 and a process ID of 
1 are special processes and are referred to as procO and 
procl. 


ProcQ is the scheduler. Proci is the initialization 
process (init). Procl is the ancestor of every other 
process in the system and is used to control the process 
structure. 


Descriptor 

A file descriptor is a small integer used to do I/O on a 
file. The value of a file descriptor is from 0 to 19. A 
process may have no more than 20 file descriptors (0-19) 
open simultaneously. A file descriptor is returned by 
system calls such as open(2), or pipe(2). The file 
descriptor is used as an argument by calls such as 
read(2), write(2), toct2), and close(2). 

Name 

Names consisting of 1 to 14 characters may be used to 
name an ordinary file, special file or directory. 
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These characters may be selected from the set of all 
character values excluding \0 (null) and the ASCII code 
for / (slash). 


Note that it is generally unwise to use *, ?, [, or | as part 
of file names because of the special meaning attached to 
these characters by the shell. See sh(1). Although 
permitted, it is advisable to avoid the use of unprintable 
characters in file names. 


Path Name and Path Prefix 
A path name is a null-terminated character string 
starting with an optional slash (/), followed by zero or 
more directory names separated by slashes, optionally 
followed by a file name. 


More precisely, a path name is a _null-terminated 
character string constructed as follows: 


<path-name > ::—= <file-name >| <path-prefix > <file- 
name> |/ 

<path-prefix > ::= <rtprefix >| /<rtprefix> 

<rtprefix > ::—=< dirname > /| <rtprefix > <dirname> / 
where <file-name> is a string of 1 to 14 characters 
other than the ASCII slash and null, and <dirname> is 
a string of 1 to 14 characters (other than the ASCII slash 
and null) that names a directory. Any number of 
consecutive slashes is equivalent to a single slash. 


If a path name begins with a slash, the path search 
begins at the root directory. Otherwise, the search 
begins from the current working directory. 


A slash by itself names the root directory. 


Unless specifically stated otherwise, the null path name 
is treated as if it named a non-existent file. 


Directory 
Directory entries are called links. By convention, a 
directory contains at least two links, . and .., referred to 
as dot and dot-dot respectively. Dot refers to the 
directory itself and dot-dot refers to its parent directory. 


Root Directory and Current Working Directory 
Each process has associated with it a concept of a root 
directory and a current working directory for the purpose 
of resolving path name searches. The root directory of a 
process need not be the root directory of the root file 
system. 


File Access Permissions 
Read, write, and execute/search permissions on a file are 
granted to a process if one or more of the following are 
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true: 
The effective user ID of the process is super-user. 


The effective user ID of the process matches the 
user ID of the owner of the file and the 
appropriate access bit of the “owner” portion 
(0700) of the file mode is set. 


The effective user ID of the process does not 
match the user ID of the owner of the file, and 
the effective group ID of the process matches the 
group of the file and the appropriate access bit 
of the ‘‘group”’ portion (070) of the file mode is 
set. 


The effective user ID of the process does not 
match the user ID of the owner of the file, and 
the effective group ID of the process does not 
match the group ID of the file, and the 
appropriate access bit of the “‘other’’ portion 
(07) of the file mode is set. 


Otherwise, the corresponding permissions are denied. 


Message Queue Identifier 
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A message queue identifier (msqid) is a unique positive 
integer created by a msgget(2) system call. Each msqid 
has a message queue and a data structure associated with 
it. The data structure is referred to as msgid_ds and 
contains the following members: 


struct ipc_perm msg_perm; 
/* operation permission struct */ 
ushort msg_qnum; /* number of msgs on q */ 
ushort msg_qbytes; /* max number of bytes on q */ 
ushort msg_lIspid; /* pid of last msgsnd operation */ 
ushort msg_Irpid; /* pid of last msgrev operation */ 
time_t msg_stime; /* last msgsnd time */ 
time_t msg_rtime; /* last msgrev time */ 
time_t msg_ctime; /* last change time */ 
/* Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 


Msg_perm is an ipc_perm structure that specifies the 
message operation permission (see below). This structure 
includes the following members: 


ushort —cuid; /* creator user id */ 

ushort —cgid; /* creator group id */ 

ushort uid; /* user id */ 

ushort — gid; /* group id */ 

ushort mode; /* r/w permission */ 
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Msg_qnum is the number of messages currently on the 
queue. Msg_qbytes is the maximum number of bytes 
allowed on the queue. Msg_Ispid is the process id of 
the last process that performed a msgsnd operation. 
Msg_lIrpid is the process id of the last process that 
performed a msgrcv operation. Msg_stime is the time 
of the last msgsnd operation, msg_rtime is the time of 
the last msgrcv operation, and msg_ctime is the time of 
the last tage) operation that changed a member of 
the above structure. 


Message Operation Permissions 


In the msgop(2) and msgctl(2) system call descriptions, 
the permission required for an operation is given as 
"{token}”, where "token” is the type of permission 
needed interpreted as follows: 


00400 Read by user 
00200 Write by user 
00060 Read, Write by group 
00006 Read, Write by others 


Read and Write permissions on a msqid are granted to a 
process if one or more of the following are true: 


The effective user ID of the process is super-user. 


The effective user ID of the process matches 
msg_perm.|c uid in the data _— structure 
associated with msgid and the appropriate bit of 
the ‘“‘user” portion (0600) of msg_perm.mode 
is set. 


The effective user ID of the process does not 
match msg_perm.[c]uid and the effective 
group ID of the process matches 
msg_perm.|c]gid and the appropriate bit of the 
“group” portion (060) of msg_perm.mode is 
set. 


The effective user ID of the process does not 
match msg_perm.|c]uid and the effective 
group ID of the process does not match 
msg_perm.|c]gid and the appropriate bit of the 
“other” portion (06) of msg_perm.mode is set. 


Otherwise, the corresponding permissions are denied. 


Semaphore Identifier 
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A semaphore identifier (semid) is a unique positive 
integer created by a semget(2) system call. Each semid 
has a set of semaphores and a data structure associated 
with it. The data structure is referred to as semid_ds 
and contains the following members: 


tat ee 


INTRO (2) 


struct ipc_perm sem_perm; 

/* operation permission struct */ 
ushort sem_nsems; /* number of sems in set */ 
time_t sem_otime; /* last operation time */ 
time_t sem_ctime; /* last change time */ 

*Times measured in secs */ 
* since 00:00:00 GMT, */ 

/*Jan. 1, 1970 */ 

Sem_perm is an ipc_perm structure that specifies the 


semaphore operation permission (see below). This 
structure includes the following members: 


ushort —cuid; /* creator user id */ 
ushort cgid; /* creator group id */ 
ushort uid; /* user id */ 

ushort gid; /* group id */ 

ushort mode; /* r/a permission */ 


The value of sem_nsems is equal to the number of 
semaphores in the set. Each semaphore in the set is 
referenced by a positive integer referred to as a 
sem_num. Sem_num values run sequentially from 0 to 
the value of sem_nsems minus 1. Sem_otime is the 
time of the last semop(2) operation, and sem_ctime is 
the time of the last semctl(2) operation that changed a 
member of the above structure. 


A semaphore is a data structure that contains the 
following members: 


ushort semval; /* semaphore value */ 

short — sempid; /* pid of last operation */ 
ushort semnecnt; /* # awaiting semval > cval */ 
ushort semzcnt; /* # awaiting semval = 0 */ 


Semval is a non-negative integer. Sempid is equal to 
the process ID of the last process that performed a 
semaphore operation on this semaphore. Semnent is a 
count of the number of processes that are currently 
suspended awaiting this semaphore’s semval to become 
greater than its current value. Semzcnt is a count of 
the number of processes that are currently suspended 
awaiting this semaphore’s semval to become zero. 


Semaphore Operation Permissions 
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In the semop(2) and semetl(2) system call descriptions, 
the permission required for an operation is given as 
"{token}”, where “token” is the type of permission 
needed interpreted as follows: 


00400 Read by user 
00200 Alter by user 
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00060 Read, Alter by group 
00006 Read, Alter by others 


Read and Alter permissions on a semid are granted to a 
process if one or more of the following are true: 


The effective user ID of the process is super-user. 


The effective user ID of the process matches 
sem_perm.|cluid in the data structure 
associated with semid and the appropriate bit of 
the “user” portion (0600) of sem_perm.mode 
is set. 


The effective user ID of the process does not 
match sem_perm.|cjuid and the effective group 
ID of the process matches sem_perm.|c]gid and 
the appropriate bit of the “group” portion (060) 
of sem_perm.mode is set. 


The effective user ID of the process does not 
match sem_perm.|{cluid and the effective group 
ID of the process does not match 
sem_perm.|c]gid and the appropriate bit of the 
“other” portion (06) of sem_perm.mode is set. 


Otherwise, the corresponding permissions are denied. 


Shared Memory Identifier 

A shared memory identifier (shmid) is a unique positive 
integer created by a shmget(2) system call. Each shmid 
has a segment of memory (referred to as a shared 
memory segment) and a data structure associated with 
it. The data structure is referred to as shmid_ds and 
contains the following members: 


struct 


int 
ushort 
ushort 
short 
time_t 
time_t 
time_t 


ipc_perm shm_perm; 
/* operation permission struct */ 
shm_segsz; /* size of segment */ 
shm_cpid;  /* creator pid */ 
shm_lpid; _/* pid of last operation */ 
shm_nattch; /* number of current attaches */ 
shm_atime; /* last attach time */ 
shm_dtime; /* last detach time */ 
shm_ctime; /* last change time */ 
/* Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 


Shm_perm is an ipc_perm structure that specifies the 
shared memory operation permission (see below). This 
structure includes the following members: 


ushort —cuid; /* creator user id */ 
ushort —cgid; /* creator group id */ 
ushort uid; /* user id */ 
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ushort gid; /* group id */ 
ushort mode; /* r/w permission */ 


Shm_segsz specifies the size of the shared memory 
segment. Shm_cpid is the process id of the process that 
created the shared memory identifier. Shm_Ipid is the 
process id of the last process that performed a shmop(2) 
operation. Shm_nattch is the number of processes that 
currently have this segment attached. Shm_atime is 
the time of the last shmat operation, shm_dtime is the 
time of the last shmdt operation, and shm_ctime is the 
time of the last shmcél(2) operation that changed one of 
the members of the above structure. 


Shared Memory Operation Permissions 


In the shmop(2) and shmcetl(2) system call descriptions, 
the permission required for an operation is given as 
"{token}", where “token” is the type of permission 
needed interpreted as follows: 


00400 Read by user 
00200 Write by user 
00060 Read, Write by group 
00006 Read, Write by others 


Read and Write permissions on a shmid are granted to a 
process if one or more of the following are true: 


The effective user ID of the process is super-user. 


The effective user ID of the process matches 
shm_perm.|cJuid in the data structure 
associated with shmizd and the appropriate bit of 
the “user” portion (0600) of shm_perm.mode 
is set. 


The effective user ID of the process does not 
match shm_perm.|cluid and the effective 
group ID of the process matches 
shm_perm.|c]gid and the appropriate bit of the 
“group”? portion (060) of shm_perm.mode is 
set. 


The effective user ID of the process does not 
match shm_perm.[cluid and the effective 
group ID of the process does not match 
shm_perm. [c]gid and the appropriate bit of the 
“other” portion (06) of shm_perm.mode is set. 


Otherwise, the corresponding permissions are denied. 


SEE ALSO 
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intro(3). 
CTIX Internetworking Manual. 


close 3 ioctl(2), open(2), pipe(2), read(2), write(2), 
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NAME 
accept — accept a connection on a socket 


— SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


accept(s, addr, addrlen) 
int 8; 

struct sockaddr *addr; 
int *addrlen; 


DESCRIPTION 
Accept accepts a connection on a socket. The argument 
s is a socket which has been created with socket(2), 
bound to an address with bind(2), and is listening for 
connections after a listen(2). Accept extracts the first 
connection on the queue of pending connections, creates 
a new socket with the same properties of s and allocates 
a new file descriptor for the socket. If no pending 
connections are present on the queue, and the socket is 
not marked as non-blocking, accept blocks the caller 
until a connection is present. If the socket is marked 
non-blocking and no pending connections are present on 
— the queue, accept returns an error as described below. 
The accepted socket, ns, may not be used to accept 
more connections. The original socket s remains open. 


The argument addr is a result parameter which is filled 
in with the address of the connecting entity, as known to 
the communications layer. The exact format of the addr 
parameter is determined by the domain in which the 
communication is occurring. The addrlen is a value- 
result parameter; it should initially contain the amount 
of space pointed to by addr; on return it will contain the 
actual length (in bytes) of the address returned. This 
call is used with connection-based socket types, currently 
with SOCK_STREAM. 
RETURN VALUE 

The call returns -1 on error. If it succeeds it returns a 
non-negative integer which is a descriptor for the 
accepted socket. 


ERRORS 
The accept will fail if: 
[EBADF] The descriptor is invalid. 
[ENOTSOCK] The descriptor references a file, 


not a socket. 


[EOPNOTSUPP] The referenced socket is not of 
type SOCK_STREAM. 
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[EFAULT] The addr parameter is not in a 
writable part of the user address 
space. 

SEE ALSO 


bind(2N), connect(2N), listen(2N), socket(2N). 
CTIX Internetworking Manual. 


NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 


ACCESS (2) 


access — determine accessibility of a file 


SYNOPSIS 


int access (path, amode) 
char *path; 
int amode; 


DESCRIPTION 


Path points to a path name naming a file. Access 
checks the named file for accessibility according to the 
bit pattern contained in amode, using the real user ID in 
place of the effective user ID and the real group ID in 
place of the effective group ID. The bit pattern 
contained in amode is constructed as follows: 


04 read 

02 write 

01 execute (search) 

00 check existence of file 


Access to the file is denied if one or more of the 
following are true: 


ENOTDIR| A component of the path prefix is not a 
directory. 

ENOENT| Read, write, or execute (search) 
permission is requested for a null path 
name. 

ENOENT| The named file does not exist. 

EACCES] Search permission is denied on a 
component of the path prefix. 

EROFS} Write access is requested for a file on a 
read-only file system. 

ETXTBSY| 
Write access is requested for a pure 
procedure (shared text) file that is being 
executed. 

[EACCES] 

Permission bits of the file mode do not 
permit the requested access. 

[EFAULT] 


Path points. outside the allocated 
address space for the process. 


The owner of a file has permission checked with respect 
to the “owner” read, write, and execute mode bits. 
Members of the file’s group other than the owner have 
permissions checked with respect to the “group” mode 
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bits, and all others have permissions checked with 
respect to the “other” mode bits. 


RETURN VALUE 
If the requested access is permitted, a value of 0 is 
returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
chmod(2), stat(2). 


— 


NAME 


ACCT (2) 


acct — enable or disable process accounting 


SYNOPSIS 


int acct (path) 
char *path; 


DESCRIPTION 


Acct is used to enable or disable the system process 
accounting routine. If the routine is enabled, an 
accounting record will be written on an accounting file 
for each process that terminates. Termination can be 
caused by one of two things: an eztt call or a signal; see 
exit(2) and stgnal(2). The effective user ID of the calling 
process must be super-user to use this call. 


Path points to a path name naming the accounting file. 
The accounting file format is given in accé(4). 


The accounting routine is enabled if path is non-zero and 
no errors occur during the system call. It is disabled if 
path is zero and no errors occur during the system call. 


Acct will fail if one or more of the following are true: 


EPERM|] The effective user of the calling process 
is not super-user. 

EBUSY] An attempt is being made to enable 
accounting when it is already enabled. 

ENOTDIR] A component of the path prefix is not a 
directory. 

ENOENT] One or more components of the 
accounting file path name do not exist. 

EACCES] A component of the path prefix denies 
search permission. 

EACCES} The file named by path is not an 
ordinary file. 

EACCES] Mode permission is denied for the 
named accounting file. 

EISDIR}] The named file is a directory. 

EROFS] The named file resides on a read-only 
file system. 

EFAULT] Path points to an illegal address. 


RETURN VALUE 


Upon successful completion, a value of O is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 
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SEE ALSO 
exit(2), signal(2), acct(4). 


ALARM(2) 


NAME 
alarm — set a process alarm clock 


aon SYNOPSIS 
unsigned alarm (sec) 
unsigned sec; 
DESCRIPTION 


Alarm instructs the alarm clock of the calling process to 
send the signal SIGALRM to the calling process after 
the number of real time seconds specified by sec have 
elapsed; see signal(2). 


Alarm requests are not stacked; successive calls reset the 
alarm clock of the calling process. 


If sec is 0, any previously made alarm request is 
canceled. 

RETURN VALUE 
Alarm returns the amount of time previously remaining 
in the alarm clock of the calling process. 

SEE ALSO 
pause(2), signal(2). 
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NAME, 
bind - bind a name to a socket 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


bind (s, name, namelen) 
int 8; 

struct sockaddr *name; 
int namelen; 


DESCRIPTION 
Bind assigns a name to an unnamed socket. When a 
socket is created with socket(2N), it exists in a name 
space (address family) but has no name assigned. Bind 
requests that name be assigned to the socket. 


NOTES 
The rules used in name binding vary between 
communication domains. Consult the manual entries in 
section 4 for detailed information. 


RETURN VALUE 
If the bind is successful, a O value is returned. A return 
value of —1 indicates an error, which is further specified 
in the global errno. 


ERRORS 
The bind call will fail if: 
[EBADF] Sis not a valid descriptor. 
[ENOTSOCK] S is not a socket. 


[EADDRNOTAVAIL] The specified address is not 
available from the local machine. 


[EADDRINUSE] The specified address is already in 
use. 

[EINVAL] The socket is already bound to an 
address. 

EACCESS] The requested address is 


protected, and the current user 
has inadequate permission to 


access it. 

[EFAULT] The name parameter is not in a 
valid part of the user address 
space. 


SEE ALSO 
connect(2N), getsockname(2N), listen(2N), socket(2N). 
CTIX Internetworking Manual. 
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NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 


BRK (2) 


brk, sbrk — change data segment space allocation 


SYNOPSIS 


int brk (endds) 
char *endds; 


char *sbrk (incr) 
int incr; 


DESCRIPTION 


Brk and sbrk are used to change dynamically the 
amount of space allocated for the calling process’s data 
segment; see ezec(2). The change is made by resetting 
the process’s break value and allocating the appropriate 
amount of space. The break value is the address of the 
first location beyond the end of the data segment. The 
amount of allocated space increases as the break value 
increases. The newly allocated space is set to zero. 


Brk sets the break value to endds and changes the 
allocated space accordingly. 


Sbrk adds iner bytes to the break value and changes the 
allocated space accordingly. Incr can be negative, in 
which case the amount of allocated space is decreased. 


Brk and sbrk will fail without making any change in the 
allocated space if one or more of the following are true: 


[ENOMEM] 
Such a change would result in more space 
being allocated than is allowed by a system- 
imposed maximum (see ulimit(2)). Note that 
due to a lack of swap space this may be less 
than what ulimit(2) reports. 


[ENOMEM] 
Such a change would result in the break 
value being greater than or equal to the start 
address of any attached shared memory 
segment (see shmop(2)). 


RETURN VALUE 


Upon successful completion, brk returns a value of 0 and 
sbrk returns the old break value. Otherwise, a value of 
—1 is returned and errno is set to indicate the error. 


SEE ALSO 


exec(2). 


CHDIR (2) 


NAME 
chdir — change working directory 


SYNOPSIS 
int chdir (path) 
char *path; 


DESCRIPTION 
Path points to the path name of a directory. Chdir 
causes the named directory to become the current 
working directory, the starting point for path searches 
for path names not beginning with /. 


Chdir will fail and the current working directory will be 
unchanged if one or more of the following are true: 


[ENOTDIR} A component of the path name is not a 
directory. 

[ENOENT] The named directory does not exist. 

[EACCES] Search permission is denied for any 
component of the path name. 

{EFAULT] Path points outside the allocated 


address space of the process. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
chroot(2). 


CHMOD (2) 


NAME 
chmod — change mode of file 


SYNOPSIS 
int chmod (path, mode) 
char *path; 
int mode; 


DESCRIPTION 
Path points to a path name naming a file. Chmod sets 
the access permission portion of the named file’s mode 
according to the bit pattern contained in mode. 


Access permission bits are interpreted as follows: 


04000 Set user ID on execution. 

02000 Set group ID on execution. 

01000 Save text image after execution. 

00400 Read by owner. 

00200 Write by owner. 

00100 Execute (search if a directory) by owner. 
00070 Read, write, execute (search) by group. 
00007 ~=—Read, write, execute (search) by others. 


The effective user ID of the process must match the 
owner of the file or be super-user to change the mode of 
a file. 


If the effective user ID of the process is not super-user, 
mode bit 01000 (save text image on execution) is cleared. 


If the effective user ID of the process is not super-user 
and the effective group ID of the process does not match 
the group ID of the file, mode bit 02000 (set group ID on 
execution) is cleared. 


If an executable file is prepared for sharing then mode 
bit 01000 prevents the system from abandoning the 
swap-space image of the program-text portion of the file 
when its last user terminates. Thus, when the next user 
of the file executes it, the text need not be read from the 
file system but can simply be swapped in, saving time. 


Chmod will fail and the file mode will be unchanged if 
one or more of the following are true: 


[ENOTDIR] A component of the path prefix is not a 
directory. 

[ENOENT] The named file does not exist. 

[EACCES|] Search permission is denied on a 
component of the path prefix. 

[EPERM|] The effective user ID does not match 


the owner of the file and the effective 


a ee 


CHMOD (2) 


user ID is not super-user. 


[EROFS| The named file resides on a read-only 
file system. 
[EFAULT] Path points outside the allocated 


address space of the process. 
RETURN VALUE 
Upon successful completion, a value of O is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 
SEE ALSO 
chown(2), mknod(2). 
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NAME 
chown — change owner and group of a file 


SYNOPSIS 
int chown (path, owner, group) 
char *path; 
int owner, group; 


DESCRIPTION 
Path points to a path name naming a file. The owner ID 
and group ID of the named file are set to the numeric 
values contained in owner and group respectively. 


Only processes with effective user ID equal to the file 
owner or super-user may change the ownership of a file. 


If chown is invoked by other than the super-user, the 
set-user-ID and set-group-ID bits of the file mode, 04000 
and 02000 respectively, will be cleared. 


Chown will fail and the owner and group of the named 
file will remain unchanged if one or more of the 
following are true: 


ENOTDIR] A component of the path prefix is not a 
directory. 

ENOENT| The named file does not exist. 

EACCES] Search permission is denied on a 
component of the path prefix. 

EPERM] The effective user ID does not match 


the owner of the file and the effective 
user ID is not super-user. 


EROFS|] The named file resides on a read-only 
file system. 
EFAULT] Path points outside the allocated 


address space of the process. 
RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 
SEE ALSO 
chown(1), chmod(2). 
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NAME 


CHROOT (2) 


chroot — change root directory 


SYNOPSIS 


int chroot (path) 
char *path; 


DESCRIPTION 


Path points to a path name naming a directory. Chroot 
causes the named directory to become the root directory, 
the starting point for path searches for path names 
beginning with /. The user’s working directory is 
unaffected by the chroot system call. 


The effective user ID of the process must be super-user to 
change the root directory. 


The .. entry in the root directory is interpreted to mean 
the root directory itself. Thus, .. cannot be used to 
access files outside the subtree rooted at the root 
directory. 


Chroot will fail and the root directory will remain 
unchanged if one or more of the following are true: 


[ENOTDIR] Any component of the path name is not 
a directory. 

{ENOENT] The named directory does not exist. 

{EPERM] The effective user ID is not super-user. 

[EFAULT] Path points outside the allocated 


address space of the process. 


RETURN VALUE 


Upon successful completion, a value of O is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


chdir(2). 


CLOSE(2) 


NAME 
close — close a file descriptor 


SYNOPSIS 
int close (fildes) 
int fildes; 


DESCRIPTION 
Fildes is a file descriptor obtained from a creat, open, 
dup, fentl, or pipe system call. Close closes the file 
descriptor indicated by fildes. All outstanding record 
locks owned by the process (on the file indicated fildes) 
are removed. 


[EBADF] Close will fail if fildes is not a valid open file 
descriptor. 

RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
creat(2), dup(2), exec(2), fentl(2), open(2), pipe(2). 


ya 


ame. 


NAME 


CONNECT (2N) 


connect — initiate a connection on a socket 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/socket.h> 


connect (s, name, namelen) 
int 8; 

struct sockaddr *name; 
int namelen; 


DESCRIPTION 


Connect initiates a connection on a socket. The 
parameter 8 is a socket. If it is of type SOCK_DGRAM, 
then this call permanently specifies the peer to which 
datagrams are to be sent; if it is of type 
SOCK_STREAM, then this call attempts to make a 
connection to another socket. The other socket is 
specified by name; namelen is the length of name. which 
is an address in the communications space of the socket. 
Each communications space interprets the name 
parameter in its own way. 


RETURN VALUE 


If the connection or binding succeeds, then 0 is returned. 
Otherwise a —1 is returned, and a more specific error 
code is stored in errno. 


ERRORS 
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The call fails if: 

[EBADF] Sis not a valid descriptor. 

[ENOTSOCK] S is a descriptor for a file, not a 
socket. 


EADDRNOTAVAIL] The specified address is not 
available on this machine. 


[EAFNOSUPPORT] Addresses in the specified address 
family cannot be used with this 


socket. 
[EISCONN] The socket is already connected. 
{ETIMEDOUT] Connection establishment timed 
out without establishing a 
connection. 


[ECONNREFUSED] The attempt to connect was 
forcefully rejected. 


[ENETUNREACH] The network is not reachable from 
this host. 
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[EADDRINUSE] The address is already in use. 
[EFAULT] The name parameter specifies an 
area outside the process address 
space. 
SEE ALSO 


accept(2N), getsockname(2N), socket(2N). 
CTIX Internetworking Manual. 


NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 


CREAT (2) 


creat — create a new file or rewrite an existing one 


SYNOPSIS 


int creat (path, mode) 
char *path; 
int mode; 


DESCRIPTION 


Creat creates a new ordinary file or prepares to rewrite 
an existing file named by the path name pointed to by 
path. 


If the file exists, the length is truncated to 0 and the 
mode and owner are unchanged. Otherwise, the file’s 
owner ID is set to the effective user ID, of the process the 
group ID of the process is set to the effective group ID, of 
the process and the low-order 12 bits of the file mode are 
set to the value of mode modified as follows: 


All bits set in the process’s file mode creation 
mask are cleared. See umask(2). 


The “‘save text image after execution bit” of the 
mode is cleared. See chmod(2). 


Upon successful completion, the file descriptor is 
returned and the file is open for writing, even if the 
mode does not permit writing. The file pointer is set to 
the beginning of the file. The file descriptor is set to 
remain open across ezec system calls. See fentl(2). No 
process may have more than 20 files open 
simultaneously. A new file may be created with a mode 
that forbids writing. 


Creat will fail if one or more of the following are true: 


EACCES] Search permission is denied on a 
component of the path prefix. 

EACCES] The file does not exist and the directory 
in which the file is to be created does 
not permit writing. 

EACCES] The file exists and write permission is 
denied. 

ENOTDIR} A component of the path prefix is not a 
directory. 

ENOENT}| A component of the path prefix does 
not exist. 

ENOENT] The path name is null. 

EROFS} The named file resides or would reside 


on a read-only file system. 
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ETXTBSY] The file is a pure procedure (shared 
text) file that is being executed. 

EISDIR}] The named file is an existing directory. 

EMFILE] Twenty (20) file descriptors are 
currently open. 

EFAULT] Path points outside the allocated 
address space of the process. 

ENFILE] The system file table is full. 

EDEADLOCK] A side effect of a previous locking(2) 


c 


RETURN VALUE 
Upon successful completion, a non-negative integer, 
namely the file descriptor, is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
chmod(2), close(2), dup(2), fentl(2), locking(2), Iseek(2), 
open(2), read(2), umask(2), write(2). 


NAME 


DUP(2) 


dup — duplicate an open file descriptor 


SYNOPSIS 


int dup (fildes) 
int fildes; 


DESCRIPTION 


Fildes is a file descriptor obtained from a creat, open, 
dup, fentl, or ptpe system call. Dup returns a new file 
descriptor having the following in common with the 
original: 


Same open file (or pipe). 


Same file pointer (i.e., both file descriptors share 
one file pointer). 


Same access mode (read, write or read/write). 


The new file descriptor is set to remain open across exec 
system calls. See fentl(2). 


The file descriptor returned is the lowest one available. 
Dup will fail if one or more of the following are true: 


[EBADF] Fildes is not a valid open file 
descriptor. 
[EMFILE] Twenty (20) file descriptors are 


currently open. 


RETURN VALUE 


Upon successful completion a non-negative integer, 
namely the file descriptor, is returned. Otherwise, a 
value of -1 is returned and errno is set to indicate the 
error. 


SEE ALSO 


creat(2), close(2), exec(2), fentl(2), open(2), pipe(2). 


NAME 


EXEC (2) 


execl, execv, execle, execve, execlp, execvp — execute a 
file 


SYNOPSIS 


int execl (path, argO, argl, ..., argn, 0) 

char *path, *argO, *argl, ..., *argn; 

int execv (path, argv) 

char *path, earavt 15 

int execle (path, argO, argl, ..., argn, 0, envp) 
char *path, *argO, *argl, ..., ee *envp[ |; 
int execve (path, rarer env 

char *path, *argv[ ], *envp 

int execlp (file, argO, argl, .... argn, 0) 

char *file, *argO, *argl, ..., *argn; 

int execvp (file, argv) 

char *file, *argv( ]; 


DESCRIPTION 


Ezec in all its forms transforms the calling process into a 
new process. The new process is constructed from an 
ordinary, executable file called the new process file. 
This file consists of a header (see a.out(4)), a text 
segment, and a data segment. The data segment 
contains an initialized portion and an _ uninitialized 
portion (bss). There can be no return from a successful 
exec because the calling process is overlaid by the new 
process. 


When aC program is executed, it is called as follows: 
main (arge, argv, envp) 
int argc; 
char **argv, **envp; 


where arge is the argument count and argv is an array of 
character pointers to the arguments themselves. As 
indicated, arge is conventionally at least one and the 
first member of the array points to a string containing 
the name of the file. 


Path points to a path name that identifies the new 
process file. 


File points to the new process file. The path prefix for 
this file is obtained by a search of the directories passed 
as the environment line "PATH =” (see environ(5)). 
The environment is supplied by the shell (see sh(1)). 


ArgO, argl, ..., argn are pointers to null-terminated 
character strings. These strings constitute the argument 
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list available to the new process. By convention, at least 
argO must be present and point to a string that is the 
same as path (or its last component). 


Argv is an array of character pointers to null-terminated 
strings. These strings constitute the argument list 
available to the new process. By convention, argv must 
have at least one member, and it must point to a string 
that is the same as path (or its last component). Argv is 
terminated by a null pointer. 


Envp is an array of character pointers to null-terminated 
strings. These strings constitute the environment for the 
new process. Envp is terminated by a null pointer. For 
ezecl and erecv, the C run-time start-off routine places 
a pointer to the environment of the calling process in the 
global cell: 
extern char **environ; 

and it is used to pass the environment of the calling 
process to the new process. 


File descriptors open in the calling process remain open 
in the new process, except for those whose close-on-exec 
flag is set; see fentl(2). For those file descriptors that 
remain open, the file pointer is unchanged. 


Signals set to terminate the calling process will be set to 
terminate the new process. Signals set to be ignored by 
the calling process will be set to be ignored by the new 
process. Signals set to be caught by the calling process 
will be set to terminate the new process; see signal(2). 


If the set-user-ID mode bit of the new process file is set 
(see chmod(2)), exec sets the effective user ID of the new 
process to the owner ID of the new process file. 
Similarly, if the set-group-ID mode bit of the new process 
file is set, the effective group ID of the new process is set 
to the group ID of the new process file. The real user ID 
and real group ID of the new process remain the same as 
those of the calling process. 


The shared memory segments attached to the calling 
process will not be attached to the new process (see 
shmop(2)). 


Profiling is disabled for the new process; see profil(2). 


The new process also inherits the following attributes 
from the calling process: 


nice value (see nice(2)) 
process ID 
parent process ID 
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process group ID 

semadj values (see semop(2)) 

tty group ID (see extt(2) and stgnal(2)) 

trace flag (see ptrace(2) request 0) 

time left until an alarm clock signal (see 
alarm(2)) 

current working directory 

root directory 

file mode creation mask (see umask(2)) 

file size limit (see ulimtt(2)) 

utime, stime, cuttme, and catime (see times(2)) 


Exec will fail and return to the calling process if one or 
more of the following are true: 


ENOENT] 


ENOTDIR] 


EACCES] 


EACCES| 


EACCES] 


ENOEXEC} 


([ETXTBSY] 


[ENOMEM} 


[E2BIG] 


One or more components of the new 
process path name of the file do not 
exist. 


A component of the new process path of 
the file prefix is not a directory. 


Search permission is denied for a 
directory listed in the new process file’s 
path prefix. 


The new process file is not an ordinary 
file. 


The new process file mode denies 
execution permission. 


The exec is not an ezeclp or execup, 
and the new process file has the 
appropriate access permission but an 
invalid magic number in its header. 


The new process file is a pure procedure 
ihe text) file that is currently open 
or writing by some process. 


The new process requires more memory 
than is allowed by the system-imposed 
maximum. ‘This limit is a configurable 
quantity up to the limitations of the 
hardware. It may be less due to 
restrictions on swap space. 


The number of bytes in the new 
process’s argument list is greater than 
the system-imposed limit of 10,240 
bytes. 


{EFAULT| 


(EFAULT] 


[ENOHDW] 


{[ENOEXEC 


[ENOEXEC 


([EPERM] 


RETURN VALUE 
If exec returns to the calling process an error has 
occurred; the return value will be -1 and errno will be 
set to indicate the error. 


SEE ALSO 
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sh(1), alarm(2), 


semop(2), 


signal(2),  times(2), ulimit(2), umask 
a.out(4), environ(5). 
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The new process file is not as long as 
indicated by the size values in its 


header. 


Path, argv, or envp point to an illegal 
address. 


The executable file requires hardware 
that does not exist (such as floating- 
point). 

The file format does not correspond to 
that expected as specified with the 


magic number (such as a hole in the 
file). 


The virtual address specification in the 
header(s) exceeds the allowed system 
limits. 

The process is being traced (see 
ptrace(2)), but the file does not permit 
reading. 


exit(2), fork(2), nice(2), ee. 
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NAME 


EXIT (2) 


exit, _exit — terminate process 


SYNOPSIS 


void exit (status) 
int status; 

void _exit (status) 
int status; 


DESCRIPTION 


Exit terminates the calling process with the following 
consequences: 


All of the file descriptors open in the calling 
process are closed. 


If the parent process of the calling process is 
executing a wait, it is notified of the calling 
process’s termination and the low order eight 
bits (i.e., bits 0377) of status are made available 
to it; see wazt(2). 


If the parent process of the calling process is not 
executing a wait, the calling process is 
transformed into a zombie process. A zombie 
process is a process that only occupies a slot in 
the process table. It has no other space 
allocated either in user or kernel space. The 
process table slot that it occupies is partially 
overlaid with time accounting information (see 
<sys/proc.h>) to be used by times. 


The parent process ID of all of the calling 
process’s existing child processes and zombie 
processes is set to 1. This means that the 
initialization process (see intro(2)) inherits each 
of these processes. 


Each attached shared memory segment is 
detached and the value of shm_nattach in the 
data structure associated with its shared memory 
identifier is decremented by 1. 


For each semaphore for which the calling process 
has set a semadj value (see semop(2)), that 
semadj value is added to the semval of the 
specified semaphore. 


If the process has a process, text, or data lock, 
an unlock is performed (see plock(2)). 


An accounting record is written on the 
accounting file if the system’s accounting routine 
is enabled; see acct (2). 
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If the process ID, tty group ID, and process group 
ID of the calling process are equal (ie., it is a 
process group leader), the SIGHUP signal is sent 
to each process that has a process group ID equal 
to that of the calling process. 


If the process is a process group leader, all 
processes in its group are made members of the 
null group. 


The C function extt may cause cleanup actions before 
the process exits. The function _eztt circumvents all 
cleanup. 
SEE ALSO 
intro(2), acct(2), plock(2), semop(2), signal(2), wait(2). 
WARNING 
See WARNING in signal(2). 


NAME 


FCNTL(2) 


fentl — file control 


SYNOPSIS 


#include <fentl.h> 


int fentl (fildes, cmd, arg) 
int fildes, cmd, arg; 


DESCRIPTION 


Fentl provides for control over open files. Fildes is an 
open file descriptor obtained from a creat, open, dup, 
fentl, or pipe system call. 


The commands available are: 


F_DUPFD 


F_GETFD 


F_SETFD 


F_GETFL 
F_SETFL 


F_GETLK 


Return a new file descriptor as follows: 


Lowest numbered available file 
descriptor greater than or equal to arg. 


Same open file (or pipe) as the original 
file. 


Same file pointer as the original file (i.e., 
both file descriptors share one file 
pointer). 


Same access mode (read, write or 
read/write). 


Same file status flags (i.e., both file 
descriptors share the same file status 
flags). 


The close-on-exec flag associated with 
the new file descriptor is set to remain 
open across erec(2) system calls. 


Get the close-on-exec flag associated 
with the file descriptor fildes. If the 
low-order bit is O the file will remain 
open across ezec, otherwise the file will 
be closed upon execution of ezec. 


Set the close-on-exec flag associated with 
fildes to the low-order bit of arg (0 or 1 
as above). 


Get file status flags. 
Set file status flags to arg. Only certain 
flags can be set; see fentl(5). 


Get the first lock which blocks the lock 
description given by the variable of type 
struct flock pointed to by arg (see 
fentl(5)). The information retrieved 
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overwrites the information passed to 
fentl in the flock structure. If no lock is 
found that would prevent this lock from 
being created, then the structure is 
passed back unchanged except for the 
lock type which will be set to F_UNLCK. 


F_SETLK Set or clear a file segment lock 
according to the variable of type struct 
flock pointed to by arg [see Soak) 
The cmd F_SETLK is used to establis 
read (F_RDLCK) and write (F_WRLCK) 
locks, as well as remove either type of 
lock (F_LUNLCK). If a read or write lock 
cannot be set, fentl will return 
immediately with an error value of —1. 


F_SETLKW This emd is the same as F_SETLK except 
that if a read or write lock is blocked by 
other locks, the process will sleep until 
the segment is free to be locked. 


A read lock prevents any process from write locking the 
protected area. More than one read lock may exist for a 
given segment of a file at a given time. The file 
descriptor on which a read lock is being placed must 
have been opened with read access. 


A write lock prevents any process from read locking or 
write locking the protected area. Only one write lock 
may exist for a given segment of a file at a given time. 
The file descriptor on which a write lock is being placed 
must have been opened with write access. 


The structure flock describes the type (‘_type), starting 
offset (l_whence), relative offset (/_start), size (i_len), and 
process id (l_pid) of the segment of the file to be 
affected. The process id field is only used with the 
F_GETLK emd to return the value for a block in lock. 
Locks may start and extend beyond the current end of a 
file, but may not be negative relative to the beginning of 
the file. A lock may be set to always extend to the end 
of file by setting (_len to zero (0). If such a lock also has 
l_start set to zero (0), the whole file will be locked. 
Changing or unlocking a segment from the middle of a 
larger locked segment leaves two smaller segments for 
either end. Locking a segment that is already locked by 
the calling process causes the old lock type to be 
removed and the new lock type to take effect. All locks 
associated with a file for a given process are removed 
when a file descriptor for that file is closed by that 
process or the process holding that file descriptor 
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terminates. Locks are not inherited by a child process in 
a fork(2) system call. 


Fentl will fail if one or more of the following are true: 


EBADF] 
EMFILE] 
EINFILE] 


EINVAL] 


EACCES] 


[EMFILE] 


[ENOSPC} 


[EDEADLK] 


RETURN VALUE 


Fildes is not a valid open file 
descriptor. 


Cmd is F_DUPFD and 20 file descriptors 
are currently open. 


Cmd is F_DUPFD and arg is negative or 
greater than 20. 


Cmd is F_GETLK, F_SETLK, or 
SETLKW and arg or the data it points 
to is not valid. 


Cmd is F_SETLK; the type of lock 
l_type) is a read (F_RDLCK) or write 
F_WRLCK lock, and the segment of a 
ile to be locked is already write locked 
by another process; or the type is a 
write lock, and the segment of a file to 
be locked is already read or write 
locked by another process. 


Cmd is F_SETLK or F_SETLKW, the 
type of lock is a read or write lock and 
there are no more file locking headers 
available (too many files have segments 
locked). 


Cmd is F_SETLK or F_SETLKW, the 
type of lock is a read or write lock and 
there are no more file locking headers 
available (too many files have segments 
locked) or there are no more record 


locks available (too many file segments 
locked). 


Cmd is F_SETLK, when the lock is 
blocked by some lock from another 
process and sleeping (waiting) for that 
lock to become free, this causes a 
deadlock situation. 


Upon successful completion, the value returned depends 
on emd as follows: 

F_DUPFD A new file descriptor. 

F_GETFD Value of flag (only the low-order 


bit is defined). 
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F_SETFD Value other than -1. 
F_GETFL Value of file flags. 

F_SETFL Value other than —-1. 
F_GETLK Value other that -1. 
F_SETLK Value other than —1. 


F_SETLKW Value other than -1. 

Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
close(2), exec(2), open(2), fentl(5). 

BUGS 
Two forms of file locking are available: locking(2) and 
fentl(2). These two methods are not compatible; a lock 
by one is not honored by the other. 
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NAME 
fork — create a new process 


SYNOPSIS 
int fork () 


DESCRIPTION 
Fork causes creation of a new process. The new process 
child process) is an exact copy of the calling process 
parent process). This means the child process inherits 
the following attributes from the parent process: 


environment 
close-on-exec flag (see ezec(2)) 
signal handling settings (ie.. SIG_DFL, 
SIG_IGN, function address) 
set-user-ID mode bit 
set-group-ID mode bit 
profiling on/off status 
nice value (see nice(2)) 
all attached shared memory segments (see 
shmop(2)) 
process group ID 
tty group ID (see eatt(2) and stgnal(2)) 
trace flag (see ptrace(2) request 0) 
time left until an alarm clock signal (see 
alarm(2)) 
current working directory 
root directory 
file mode creation mask (see umask(2)) 
file size limit (see ulimst(2)) 
The child process differs from the parent process in the 
following ways: 


The child process has a unique process ID. 


The child process has a different parent process 
ID (i.e., the process ID of the parent process). 


The child process has its own copy of the 
parent’s file descriptors. Each of the child’s file 
descriptors shares a common file pointer with 
the corresponding file descriptor of the parent. 


All semadj values are cleared (see semop(2)). 


Process locks, text locks and data locks are not 
inherited by the child plock(2)). 


The child process’s utime, stime, cutime, and 
cstime are set toO. The time left until an alarm 
clock signal is reset to 0. 
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F_SETFD Value other than -1. 
F_GETFL Value of file flags. 

F_SETFL Value other than -1. 
F_GETLK Value other that -1. 
F_SETLK Value other than -1. 


F_SETLKW Value other than -1. 

Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
close(2), exec(2), open(2), fentl(5). 

BUGS 
Two forms of file locking are available: locking(2) and 
fentl(2). These two methods are not compatible; a lock 
by one is not honored by the other. 
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NAME 


fork — create a new process 


SYNOPSIS 
int fork () 


DESCRIPTION 
Fork causes creation of a new process. The new process 
child process) is an exact copy of the calling process 
parent process). This means the child process inherits 
the following attributes from the parent process: 


environment 
close-on-exec flag (see ezec(2)) 
signal handling settings (ie., SIG_DFL, 
SIG_IGN, function address) 
set-user-ID mode bit 
set-group-ID mode bit 
profiling on/off status 
nice value (see nice(2)) 
all attached shared memory segments (see 
shmop(2)) 
process group ID 
tty group ID (see ezit(2) and signal(2)) 
trace flag (see ptrace(2) request 0) 
time left until an alarm clock signal (see 
alarm(2)) 
current working directory 
root directory 
file mode creation mask (see umask(2)) 
file size limit (see ulim#t(2)) 
The child process differs from the parent process in the 
following ways: 


The child process has a unique process ID. 


The child process has a different parent process 
ID (i.e., the process ID of the parent process). 


The child process has its own copy of the 
parent’s file descriptors. Each of the child’s file 
descriptors shares a common file pointer with 
the corresponding file descriptor of the parent. 


All semadj values are cleared (see semop(2)). 


Process locks, text locks and data locks are not 
inherited by the child plock(2)). 


The child process’s utime, stime, cutime, and 
cstime are set to 0. The time left until an alarm 
clock signal is reset to 0. 
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Fork will fail and no child process will be created if one 
or more of the following are true: 


|EAGAIN] The system-imposed limit on the total 
number of processes under execution 
would be exceeded. 


[EAGAIN] The system-imposed limit on the total 
number of processes under execution by 
a single user would be exceeded. 


RETURN VALUE 
Upon successful completion, fork returns a value of 0 to 
the child process and returns the process ID of the child 
process to the parent process. Otherwise, a value of -1 
is returned to the parent process, no child process is 
created, and errno is set to indicate the error. 


SEE ALSO 
exchanges(2), exec(2), nice(2),  plock(2), eee f 
semop(2), shmop(2), signal(2), times(2), ulimit(2 
umask(2), wait(2). 
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NAME 

getpeername — get name of connected peer 
SYNOPSIS 

getpeername(s, name, namelen) 

int 8; 


struct sockaddr *name; 
int *namelen; 


DESCRIPTION 
Getpeername returns the name of the peer connected to 
socket s. The namelen parameter should be initialized 
to indicate the amount of space pointed to by name. On 
return it contains the actual size of the name returned 


(in bytes). 
DIAGNOSTICS 

A 0 is returned if the call succeeds, —1 if it fails. 
ERRORS 

The call succeeds unless: 

EBADF] The argument s is not a valid 


descriptor. 
[ENOTSOCK] The argument s is a file, not a socket. 
[ENOTCONN] The socket is not connected. 


[ENOBUFS] Insufficient resources were available in 
the system to perform the operation. 
[EFAULT] The name parameter points to memory 


not in a valid part of the process 
address space. 


SEE ALSO 


bind(2N), socket(2N), getsockname(2N). 
CTIX Internetworking Manual. 


NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
getpid, getpgrp, getppid - get process, process group, 
and parent process IDs 

SYNOPSIS 
int getpid () 
int getpgrp () 
int getppid () 

DESCRIPTION 
Getpid returns the process ID of the calling process. 
Getpgrp returns the process group ID of the calling 
process. 
Getpptd returns the parent process ID of the calling 
process. 


SEE ALSO 
exec(2), fork(2), intro(2), setpgrp(2), signal(2). 
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NAME 
getsockname — get socket name 
SYNOPSIS 
getsockname(s, name, namelen) 
int 8; 


struct sockaddr *name; 
int *namelen; 


DESCRIPTION 
Getsockname returns the current name for the specified 
socket (s). The namelen parameter should be initialized 
to indicate the amount of space pointed to by name. On 
return namelen contains the actual size of the name 
returned (in bytes). 


RETURN VALUE 
A 0 is returned if the call succeeds, —1 if it fails. 


ERRORS 
The call succeeds unless: 
[EBADF} The argument 8s is not a valid 
descriptor. 
[ENOTSOCK]} The argument s is a file, not a socket. 
[ENOBUFS]| Insufficient resources were available in 
the system to perform the operation. 
[EFAULT]| The name parameter points to memory 
not in a valid part of the process 
address space. 
SEE ALSO 


bind(2N), socket(2N). 
CTIX Internetworking Manual. 
NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
getsockopt, setsockopt — get and set options on sockets 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


getsockopt(s, level, optname, optval, optlen) 
int 8s, level, optname; 

char *optval; 

int *optlen; 


setsockopt(s, level, optname, optval, optlen) 
int s, level, optname; 

char “*optval; 

int optlen; 


DESCRIPTION 
Getsockopt and setsockopt manipulate options associated 
with a socket. Options may exist at multiple protocol 
levels; they are always present at the uppermost 
“‘socket”’ level. 


When manipulating socket options the level at which the 
option resides and the name of the option must be 
specified. To manipulate options at the ‘‘socket’’ level, 
level is specified as SOL_SOCKET. To manipulate 
options at any other level the protocol number of the 
appropriate protocol controlling the option is supplied. 
For example, to indicate an option is to be interpreted 
by the TCP protocol, /evel should be set to the protocol 
number of TCP; see getprotoent(3N). 


The parameters optval and optlen are used to access 
option values for setsockopt. For getsockopt they 
identify a buffer in which the value for the requested 
eptionl(s) are to be returned. For getsockopt, optlen is a 
value-result parameter, initially containing the size of 
the buffer pointed to by optval, and modified on return 
to indicate the actual size of the value returned. If no 
option value is to be supplied or returned, optval may be 
supplied as 0. 


Opiname and any specified options are passed 
uninterpreted to the appropriate protocol module for 
interpretation. The include file < sys/socket.h > 
contains definitions for ‘‘socket’’ level options; see 
socket(2N). Options at other protocol levels vary in 
format and name, consult the appropriate entries in 
(4N). 
RETURN VALUE 
A 0 is returned if the call succeeds, —1 if it fails. 
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ERRORS 
The call succeeds unless: 
[EBADF] The argument s is not a valid 
descriptor. 
[ENOTSOCK] The argument s is a file, not a 
socket. 
[ENOPROTOOPT] _ The option is unknown. 
[EFAULT] The options are not in a valid 
part of the process address space. 
SEE ALSO 


socket(2N), getprotoent(3N). 
CTIX Internetworking Manual. 
NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
getuid, geteuid, getgid, getegid — get real user, effective 
user, real group, and effective group IDs 


SYNOPSIS 
unsigned short getuid ( ) 


unsigned short geteuid () 
unsigned short getgid () 
unsigned short getegid () 


DESCRIPTION 
Getutd returns the real user ID of the calling process. 


Geteutd returns the effective user ID of the calling 
process. 
Getgid returns the real group ID of the calling process. 


Getegid returns the effective group ID of the calling 
process. 


SEE ALSO 
intro(2), setuid(2). 
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NAME 


ioctl — control device 


SYNOPSIS 
ioctl (fildes, request, arg) 
int fildes, request; 


DESCRIPTION 
Ioctl performs a variety of functions on character special 
files (devices). The write-ups of various devices in 
Section 7 discuss how tocél applies to them. 


Toctl will fail if one or more of the following are true: 


[EBADF] Fildes is not a valid open file 
descriptor. 

[ENOTTY] Fildes is not associated with a character 
special device. 

[EINVAL] Request or arg is not valid. See 
Section 7. 

[EINTR] A signal was caught during the ioctl 
system call. 

[EFAULT] The options are not in a valid part of 


the process address space. 


RETURN VALUE 
If an error has occurred, a value of —1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
termio(7). 
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NAME 


KILL(2) 


kill - send a signal to a process or a group of processes 


SYNOPSIS 


int kill (pid, sig) 
int pid, sig; 


DESCRIPTION 


Kill sends a signal to a process or a group of processes. 
The process or group of processes to which the signal is 
to be sent is specified by ptd. The signal that is to be 
sent is specified by stg and is either one from the list 
given in stgnal(2), or 0. If stg is O (the null signal), error 
checking is performed but no signal is actually sent. 
This can be used to check the validity of prd. 


The real or effective user ID of the sending process must 
match the real or effective user ID of the receiving 
process, unless the effective user ID of the sending 
process is super-user. 


The processes with a process ID of 0 and a process ID of 
1 are special processes (see intro(2)) and will be referred 
to below as procO and proc1, respectively. 


If pid is greater than zero, stg will be sent to the process 
whose process ID is equal to pid. Prd may equal 1. 


If pid is 0, stg will be sent to all processes excluding 
procO and procl whose process group ID is equal to the 
process group ID of the sender. 


If pid is —1 and the effective user ID of the sender is not 
super-user, stg will be sent to all processes excluding 
procO and proci whose real user ID is equal to the 
effective user ID of the sender. 


If ped is -1 and the effective user ID of the sender is 
super-user, stg will be sent to all processes excluding 
procO and procl. 


If pid is negative but not —1, stg will be sent to all 
processes whose process group ID is equal to the absolute 
value of pid. 


Aull will fail and no signal will be sent if one or more of 
the following are true: 


[EINVAL] Sig is not a valid signal number. 

[EINVAL] Stg is SIGKILL and péd is 1 (proc1). 

(ESRCH] No process can be found corresponding 
to that specified by pid. 

[EPERM] The user ID of the sending process is 


not super-user, and its real or effective 
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user ID does not match the real or 
effective user ID of the receiving 
process. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
kill(1), getpid(2), setpgrp(2), signal(2). 


LDDRV(2) 


NAME 
drvalloc, drvbind — access loadable drivers 


SYNOPSIS 
#iinclude <sys/types.h> 
#include <syslocal.h> 
#include <sys/drv.h> 


syslocal (SYSL_ALLOCDRY, option, ds) 
int option; 
struct drvalloc *ds; 


syslocal (SYSL_BINDDRYV, option, ds) 
int option; 
struct drvbind *ds; 

DESCRIPTION 
These two functions accessed via syslocal(2) implement 
the loadable driver functions of CTIX. They both require 
super-user privilege. 
Loading drivers consists of two phases: allocation of 
virtual space, device numbers, and device IDs; and 
binding. Fully relocating a driver into memory, 
allocating physical space, plugging the device switch 
tables, calling initialization routines, and unloading 
require the same two phases in reverse. 


SEE ALSO 
Idrv(1M), syslocal(2). 


NAME 


LINK (2) 


link — link to a file 


SYNOPSIS 


int link (pathl, path2) 
char *path1, *path2; 


DESCRIPTION 


Path1 points to a path name naming an existing file. 
Path2 points to a path name naming the new directory 
entry to be created. Link creates a new link (directory 
entry) for the existing file. 


Link will fail and no link will be created if one or more 
of the following are true: 


ENOTDIR] 
ENOENT] 
EACCES} 


ENOENT] 
EEXIST| 
EPERM| 


EXDEV| 


ENOENT]| 
EACCES| 


EROFS|] 


EFAULT| 


EMLINK] 


RETURN VALUE 


A component of either path prefix is 
not a directory. 


A component of either path prefix does 
not exist. 


A component of either path prefix 
denies search permission. 


The file named by path1 does not exist. 
The link named by path2 exists. 


The file named by pathi is a directory 
and the effective user ID is not super- 
user. 


The link named by path2 and the file 
named by path are on different logical 
devices (file systems). 


Path2 points to a null path name. 


The requested link requires writing in a 
directory with a mode that denies write 
permission. 


The requested link requires writing in a 
directory on a read-only file system. 


Path points outside the allocated 
address space of the process. 


The maximum number of links to a file 
would be exceeded. 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
unlink(2). 


NAME 


LISTEN (2N) 


listen — listen for connections on a socket 


SYNOPSIS 


listen (s, backlog) 
int s, backlog; 


DESCRIPTION 


To accept connections, a socket is first created with 
socket(2N), a backlog for incoming connections is 
specified with listen, and then the connections are 
accepted with accept(2N). The listen call applies only to 
sockets of type SOCK_STREAM or 
SOCK_PKTSTREAM. 


The backlog parameter defines the maximum length to 
which the queue of pending connections may grow. If a 
connection request arrives with the queue full the client 
will receive an error with an_ indication of 


ECONNREFUSED. 


RETURN VALUE 


ERRORS 


A 0 return value indicates success; —1 indicates an error. 

The call fails if: 

[EBADF] The argument s is not a valid 
descriptor. 

[ENOTSOCK] The argument s is not a socket. 


[EOPNOTSUPP] The socket is not of a type that 
supports the operation listen. 


SEE ALSO 


BUGS 


NOTE 
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accept(2N), connect(2N), socket(2N). 
CTIX Internetworking Manual. 


The backlog is currently limited (silently) to 5. 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 


LOCKING (2) 


locking — exclusive access to regions of a file 


SYNOPSIS 


int locking (filedes, mode, size); 
int fildes, mode; 
long size; 


DESCRIPTION 


Locking places or removes a kernel-enforced lock on a 
region of a file. The calling process has exclusive access 
to regions it has locked. If another process uses read(2), 
write(2), creat(2), or open(2) (with O_TRUNC ) in a 
way that reads or modifies part of the locked region, the 
second process’s system call does not return until the 
lock is released, unless deadlock or some other error is 
detected. A process whose execution is suspended in 
such a manner is said to be blocked. 


Parameters specify the file to be locked or unlocked, the 
kind of lock or unlock, and the region affected: 


° Filedes specifies the file to be locked or 
unlocked; filedes is a file descriptor 
returned by an open, create, pipe, fentl, 
or dup system call. 


e Mode specifies the action: O for lock 
removal; 1 for blocking lock; 2 for 
checking lock. Blocking and checking 
locks differ only if the attempted lock is 
itself locked out: a blocking lock waits 
until the existing lock or locks are 
removed; a checking lock immediately 
returns an error. 


e The region affected begins at the current 
file offset associated with ftledes and is 
stze bytes long. If stze is zero, the 
region affected ends at the end of the 
file. 


Locking imposes no structure on a CTIX file. A process 
can arbitrarily lock any unlocked byte and unlock any 
locked byte. However, creating a large number of 
noncontiguous locked regions can fill up the system’s 
lock table and make further locks impossible. It is 
advisable that a program’s use of locking segment the file 
in the same way as does the program’s use of read and 
write. 


A process is said to be deadlocked if it is sleeping until 
an unlocking which is indirectly prevented by that same 
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sleeping process. The kernel will not permit a read, 
write, creat, open with O_TRUNC, or blocking locking 
if such a call would deadlock the calling process. Errno 
is set to EDEADLOCK. The standard response to such 
a situation is for the program to release all its existing 
locked areas and try again. If a locking call fails because 
the kernel’s table of locked areas is full, again, errno is 
set to EDEADLOCK and, again, the calling program 
should release its existing locked areas. 


Special files and pipes can be locked, but no 
input/output is blocked. 


Locks are automatically removed if the process that 
placed the lock terminates or closes the file descriptor 
used to place the lock. 
SEE ALSO 
create(2), close(2), dup(2), open(2), read(2), write(2). 
RETURN VALUE 
A return value of -J1 indicates an error, with the error 
value in errno. 
[EACCES| A checking lock on a region already 
locked. 
[EDEADLOCK] A lock that would cause deadlock or 
overflow the system’s lock table. 
WARNING 
Do not apply any standard input/output library function 
to a locked file: this library does not know about locking. 
BUGS 
Two forms of file locking are available: locking(2) and 


fentl(2). These two methods are not compatible; a lock 
by one is not honored by the other. 
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NAME 
Iseek — move read/write file pointer 
SYNOPSIS 
long Iseek (fildes, offset, whence) 
int fildes; 
long offset; 
int whence; 
DESCRIPTION 
Fildes is a file descriptor returned from a creat, open, 
dup, or fentl system call. Lseek sets the file pointer 
associated with fildes as follows: 
If whence is 0, the pointer is set to offset bytes. 


If whence is 1, the pointer is set to its current 
location plus offset. 


If whence is 2, the pointer is set to the size of 
the file plus offset. 


Upon successful completion, the resulting pointer 
location, as measured in bytes from the beginning of the 
file, is returned. 


Lseek will fail and the file pointer will remain unchanged 
if one or more of the following are true: 


[EBADF] Fildes is not an open file descriptor. 
[ESPIPE] Fildes is associated with a pipe or fifo. 
[EINVAL and SIGSYS signal] 
Whence is not 0, 1, or 2. 
[EINVAL] The resulting file pointer would be 
negative. 
Some devices are incapable of seeking. The value of the 
file pointer associated with such a device is undefined. 


RETURN VALUE 
Upon successful completion, a non-negative integer 
indicating the file pointer value is returned. Otherwise, 
a value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
creat(2), dup(2), fentl(2), open(2). 
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NAME 
mknod — make a directory, or a special or ordinary file 


SYNOPSIS 
int mknod (path, mode, dev) 
char *path; 
int mode, dev; 


DESCRIPTION 
Mknod creates a new file named by the path name 
pointed to by path. The mode of the new file is 
initialized from mode. Where the value of mode is 
interpreted as follows: 
0170000 file type; one of the following: 
0010000 fifo special 
0020000 character special 
0040000 directory 
0060000 block special 
0100000 or 0000000 ordinary file 
0004000 set user ID on execution 
0002000 set group ID on execution 
0001000 save text image after execution 
0000777 access permissions; constructed from the 
following 
0000400 read by owner 
0000200 write by owner 
0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 


The owner ID of the file is set to the effective user ID of 
the process. The group ID of the file is set to the 
effective group ID of the process. 


Values of mode other than those above are undefined 
and should not be used. The low-order 9 bits of mode 
are modified by the process’s file mode creation mask: all 
bits set in the process’s file mode creation mask are 
cleared. See umask(2). If mode indicates a block or 
character special file, dev is a configuration-dependent 
specification of a character or block I/O device. If mode 
does not indicate a block special or character special 
device, dev is ignored. 


Mknod may be invoked only by the super-user for file 
types other than FIFO special. 


Mknod will fail and the new file will not be created if 
one or more of the following are true: 


[EPERM| The effective user ID of the process is 
not super-user. 


ENOTDIR] 
ENOENT] 
EROFS|] 


EEXIST| 
EFAULT] 


RETURN VALUE 
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A component of the path prefix is not a 
directory. 


A component of the path prefix does 
not exist. 


The directory in which the file is to be 
created is located on a read-only file 
system. 


The named file exists. 


Path points outside the allocated 
address space of the process. 


Upon successful completion a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


mkdir(1), chmod(2), exec(2), umask(2), fs(4). 


NAME 


MOUNT (2) 


mount — mount a file system 


SYNOPSIS 


int mount (spec, dir, rwflag) 
char *spec, *dir; 
int rwflag; 


DESCRIPTION 
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Mount requests that a removable file system contained 
on the block special file identified by spec be mounted 
on the directory identified by dir. Spee and dir are 
pointers to path names. 


Upon successful completion, references to the file dir will 
refer to the root directory on the mounted file system. 


The low-order bit of rwflag is used to control write 
permission on the mounted file system; if 1, writing is 
forbidden, otherwise writing is permitted according to 
individual file accessibility. 


Mount may be invoked only by the super-user. 
Mount will fail if one or more of the following are true: 


EPERM] The effective user ID is not super-user. 

[ENOENT] Any of the named files does not exist. 

ENOTDIR} A component of a path prefix is not a 
directory. 

ENOTBLK] Spec is not a block special device. 

ENXIO} The device associated with spec does 
not exist. 

ENOTDIR| Dtr is not a directory. 

EFAULT] Spec or dir points outside the allocated 


address space of the process. 


EBUSY] Dir is currently mounted on, is 
someone’s current working directory, or 
is otherwise busy. 

EBUSY] The device associated with spec is 
currently mounted. 


EBUSY] There are no more mount table entries. 


EROFS] The low-order bit of rwflag is zero and 
the volume containing the file system is 
physically write-protected. 


EBADFS| An attempt to mount a bit-mapped file 
system failed due to the dirty flag being 
set for that file system. 
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[ENXIO} The device is a swap partition. 

[ENXIO] The superblock found on the specified 
device does not have a correct magic 
number. 


RETURN VALUE 
Upon successful completion a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
umount(2). 
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NAME 


MSGCTL (2) 


msgctl — message control operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipe.h> 
#include <sys/msg.h> 

int msgctl (msqid, cmd, buf) 
int msqid, cmd; 

struct msqid_ds *buf; 


DESCRIPTION 


Maegctl provides a variety of message control operations 
as specified by emd. The following emds are available: 


IPC_STAT 


IPC_SET 


IPC_RMID 


Place the current value of each member 
of the data structure associated with 
msqid into the structure pointed to by 
buf. The contents of this structure are 
defined in tntro(2). {READ} 


Set the value of the following members 
of the data structure associated with 
msqtd to the corresponding value found 
in the structure pointed to by buf: 


msg_perm.uid 

msg_perm.gid 

msg_perm.mode /* only low 9 bits */ 
msg_qbytes 


This emd can only be executed by a 
process that has an effective user ID 
equal to either that of super user or to 
the value of msg_perm.uid in the data 
structure associated with msgid. Only 
super user can raise the value of 
msg_qbytes. 


Remove the message queue identifier 
specified by msgid from the system and 
destroy the message queue and data 
structure associated with it. This cmd 
can only be executed by a process that 
has an effective user ID equal to either 
that of super user or to the value of 
msg_perm.uid in the data structure 
associated with msgid. 


Msgctl will fail if one or more of the following are true: 


[EINVAL] 


[EINVAL] 
(EACCES] 


[EPERM] 


[EPERM|] 


[EFAULT| 
RETURN VALUE 
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Meqid is not a valid message queue 
identifier. 


Cmd is not a valid command. 


Cmd is equal to IPC_STAT and 
{READ} operation permission is denied 
to the calling process (see tntro(2)). 


Cmd is equal to IPC_RMID or 
IPC_SET. The effective user ID of the 
calling process is not equal to that of 
super user and it is not equal to the 
value of msg_perm.uid in the data 
structure associated with msqid. 


Cmd is equal to IPC_SET, an attempt 
is being made to increase to the value 
of msg_qbytes, and the effective user 
ID of the calling process is not equal to 
that of super user. 


Buf points to an illegal address. 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


intro(2), msgget(2), msgop(2). 
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msgget — get message queue 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/msg.h> 


int msgget (key, msgfig) 
key_t key; 
int msgfig; 


DESCRIPTION 


Msgget returns the message queue identifier associated 
with key. 


A message queue identifier and associated message queue 
and data structure (see tntro(2)) are created for key if 
one of the following are true: 


Key is equal to IPC_PRIVATE. 


Key does not already have a message queue 
identifier associated with it, and (msgflg & 
IPC_CREAT) is ‘‘true’’. 


Upon creation, the data structure associated with the 
new message queue identifier is initialized as follows: 


Msg_perm.cuid, msg_perm.uid, 
msg_perm.cgid, and msg_perm.gid are set 
equal to the effective user ID and effective group 
ID, respectively, of the calling process. 


The low-order 9 bits of msg_perm.mode are 
set equal to the low-order 9 bits of msg/flg. 


Msg_qnum, msg_lIspid, msg_Irpid, 
msg_stime, and msg_rtime are set equal to 0. 


Msg_ctime is set equal to the current time. 
Msg_qbytes is set equal to the system limit. 
Msgget will fail if one or more of the following are true: 


EACCES] A message queue identifier exists for 
key, but operation permission (see 
intro(2)) as specified by the low-order 9 
bits of msgflg would not be granted. 


ENOENT] A message queue identifier does not 
exist for key and (msgflg & 
IPC_CREAT) is “‘false’’. 


ENOSPC] A message queue identifier is to be 
created but the system-imposed limit on 
the maximum number of allowed 
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message queue identifiers system wide 
would be exceeded. 


[EEXIST] A message queue identifier exists for key 
but ( (msgflg & IPC_CREAT) & (msogflg 
& IPC_EXCL) ) is “true”. 

RETURN VALUE 

Upon successful completion, a non-negative integer, 

namely a message queue identifier, is returned. 

Otherwise, a value of -1 is returned and errno is set to 

indicate the error. 


SEE ALSO 
intro(2), msgctl(2), msgop(2). 
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NAME 


MSGOP(2) 


msgop — message operations 


SYNOPSIS 


#include <sys/types.h> 

#include <sys/ipe.h> 

#include <sys/msg.h> 

int msgsnd (msqid, msgp, msgsz, msgflg) 
int msqid; 

struct msgbuf *msgp; 

int msgsz, msgflg; 


int msgrev (msqid, msgp, msgsz, msgtyp, msgfig) 
int msqid; 

struct msgbuf *msgp; 

int msgsz; 

long msgtyp; 

int msgflg; 


DESCRIPTION 


Msgsnd is used to send a message to the queue associated 
with the message queue identifier specified by msgid. 
{WRITE} Megp points to a structure containing the 
message. This structure is composed of the following 
members: 


long mtype; /* message type */ 

char mtext||; /* message text */ 
Mtype is a positive integer that can be used by the 
receiving process for message selection (see msgrcv 
below). Mtezt is any text of length msgsz bytes. Msgsz 
can range from 0 to a system-imposed maximum. 


Msgflg specifies the action to be taken if one or more of 
the following are true: 


The number of bytes already on the queue is 
equal to msg_qbytes (see tntro(2)). 


The total number of messages on all queues 
system-wide is equal to the system-imposed 
limit. 

These actions are as follows: 
If (msgflg & IPC_NOWAIT) is “true”, the 
message will not be sent and the calling process 
will return immediately. 


If (msgflg & IPC_LNOWAIT) is “false”, the 
calling process will suspend execution until one 
of the following occurs: 
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The condition responsible for the 
suspension no longer exists, in which 
case the message is sent. 


Magid is removed from the system (see 
meet). When this occurs, errno is 
set equal to EIDRM, and a value of —1 
is returned. 


The calling process receives a signal 
that is to be caught. In this case the 
message is not sent and the calling 
process resumes execution in the 
manner prescribed in stgnal(2)). 


Msgsnd will fail and no message will be sent if one or 
more of the following are true: 


EINVAL} Msqitd is not a valid message queue 
identifier. 

EACCES] Operation permission is denied to the 
calling process (see intro(2)). 

EINVAL] Mtype is less than 1. 

EAGAIN] The message cannot be sent for one of 


the reasons cited above and (msgflg & 
IPC_NOWAIT) is “true’’. 


EINVAL] Megsz is less than zero or greater than 
the system-imposed limit. 
EFAULT] Msgp points to an illegal address. 


Upon successful completion, the following actions are 
taken with respect to the data structure associated with 
msqid (see intro (2)). 

Msg_qnum is incremented by 1. 


Msg_Ispid is set equal to the process ID of the 
calling process. 


Msg_stime is set equal to the current time. 


Msgrev reads a message from the queue associated with 
the message queue identifier specified by msgid and 
places it in the structure pointed to by msgp. {READ} 
This structure is composed of the following members: 
long mtype; /* message type * / 
char mtext|]; /* message text */ 
Mtype is the received message’s type as specified by the 
sending process. Mtezt is the text of the message. Msgsz 
specifies the size in bytes of mtezt. The received 
message is truncated to msgsz bytes if it is larger than 
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msgsz and (msgflg & MSG_NOERROR) is “true”. The 
truncated part of the message is lost and no indication of 
the truncation is given to the calling process. 


Msgtyp specifies the type of message requested as follows: 


If msgtyp is equal to 0, the first message on the 
queue is received. 


If msgtyp is greater than 0, the first message of 
type msgtyp is received. 


If msgtyp is less than 0, the first message of the 
lowest type that is less than or equal to the 
absolute value of msgtyp is received. 


Msgflg specifies the action to be taken if a message of the 
desired type is not on the queue. These are as follows: 


If (msgflg & IPCLNOWAIT) is “true”, the 
calling process will return immediately with a 
return value of -1 and errno set to ENOMSG. 


If (msgflg & IPC_NOWAIT) is “‘false’’, the 
calling process will suspend execution until one 
of the following occurs: 


A message of the desired type is placed 
on the queue. 


Msqtd is removed from the system. 
When this occurs, errno is set equal to 
EIDRM, and a value of —1 is returned. 


The calling process receives a signal 
that is to be caught. In this case a 
message is not received and the calling 
process resumes execution in the 
manner prescribed in stgnal(2)). 


Msgrcv will fail and no message will be received if one or 
more of the following are true: 


EINVAL] Msqid is not a valid message queue 
identifier. 

EACCES] Operation permission is denied to the 
calling process. 

EINVAL] Msgsz is less than 0. 

E2BIG] Mtext is greater than msgsz and (msg/flg 


& MSG_NOERROR) is “‘false’’. 


ENOMSG] The queue does not contain a message 


of the desired type and (msgtyp & 
IPC_NOWAIT) is “true’’. 
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{[EFAULT] Msgp points to an illegal address. 


Upon successful completion, the following actions are 
taken with respect to the data structure associated with 
msgid (see intro (2)). 

Msg_qnum is decremented by 1. 


Msg_Irpid is set equal to the process ID of the 
calling process. 
Msg_rtime is set equal to the current time. 
RETURN VALUES 
If msgsnd or msgrcv return due to the receipt of a signal, 
a value of —1 is returned to the calling process and errno 
is set to EINTR. If they return due to removal of msgid 


from the system, a value of -1 is returned and errno is 
set to EIDRM. 


Upon successful completion, the return value is as 
follows: 


Msgsnd returns a value of 0. 


Msgrcv returns a value equal to the number of 
bytes actually placed into mtezt. 


Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
intro(2), msgctl(2), msgget(2), signal(2). 


NAME 


NICE(2) 


nice — change priority of a process 


SYNOPSIS 


int nice (incr) 
int incr; 


DESCRIPTION 


Nice adds the value of incr to the nice value of the 
calling process. A process’s nice value is a positive 
number for which a more positive value results in lower 
CPU priority. 


The system allows nice values only from —8 to 39. The 
nice system call grants nice values from —8 to —1 only to 
super-user processes. These negative nice values cause 
the CPU priority of the process to be fixed 
independently of CPU usage of the process. Nice values 
from 0 to 39 allow the system to adjust dynamically the 
actual CPU priority of the process, temporarily lowering 
it in proportion to the process’s recent level of CPU 
usage. If a super-user process requests a nice value 
below —8, or if any other process requests a nice value 
below 0, the system imposes a nice value of 0. If any 
process requests a nice value above 39, the system 
imposes a nice value of 39. 


[EPERM] Nice will fail and not change the nice 
value if incr is negative or greater than 


40 and the effective user ID of the 
calling process is not super-user. 


RETURN VALUE 


Upon successful completion, nice returns the new nice 
value minus 20. Otherwise, a value of —1 is returned 
and errno is set to indicate the error. 


SEE ALSO 


nice(1), exec(2). 


NAME 


OPEN (2) 


open — open for reading or writing 


SYNOPSIS 


#include <fcentl.h> 

int open (path, oflag { , mode | ) 
char *path; 

int oflag, mode; 


DESCRIPTION 
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Path points to a path name naming a file. Open opens a 
file descriptor for the named file and sets the file status 
flags according to the value of oflag. Oflag values are 
constructed by OR-ing flags from the following list (only 
one of the first three flags below may be used): 


O_RDONLY Open for reading only. 
O_WRONLY 

Open for writing only. 
O_RDWR Open for reading and writing. 


O_NDELAY This flag may affect subsequent reads and 
writes. See read(2) and write(2). 


When opening a FIFO with O_RDONLY or 
O_WRONLY set: 


If O_LNDELAY is set: 


An open for reading-only will 
return without delay. An open 
for writing-only will return an 
error if no process currently has 
the file open for reading. 


If O_NDELAY is clear: 
An open for reading-only will 
block until a process opens the file 
for writing. An open for writing- 
only will block until a_ process 
opens the file for reading. 


When opening a file associated with a 
communication line: 


If O_LNDELAY is set: 


The open will return without 
waiting for carrier. 


If O_LNDELAY is clear: 


The open will block until carrier is 
present. 
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O_APPEND If set, the file pointer will be set to the 


O_DIRECT 


end of the file prior to each write. 


If set, subsequent reads or writes that 
satisfy the following criteria will be moved 
directly to or from the user space to the 
physical media: 


The transfer must start on a IK 
byte boundary in the file, and it 
must be in multiples of 1K byte 
blocks. 


This option applies only to regular files. 
Note that direct implies synchronous. 


O_NODIRECT 


O_SYNC 


O_CREAT 


O_TRUNC 


O_EXCL 


Do not perform direct I/O for this file, 
even if a transfer satisfies the system 
default criteria. 


If set, all writes will be synchronous. This 
option applies only to regular files. 


If the file exists, this flag has no effect. 
Otherwise, the owner ID of the file is set 
to the effective user ID of the process, the 
group ID of the file is set to the effective 
group ID of the process, and the low-order 
10 bits of the file mode are set to the 
value of mode modified as follows (see 
creat(2)): 
All bits set in the file mode 
creation mask of the process are 
cleared. See umask(2). 
The ‘‘save text image after 
execution bit’ of the mode is 
cleared. See chmod(2). 
If the file exists, its length is truncated to 
O and the mode and owner are unchanged. 


If O_LEXCL and O_CREAT are set, open 
will fail if the file exists. 


The file pointer used to mark the current position within 
the file is set to the beginning of the file. 


The new file descriptor is set to remain open across exec 
system calls. See fentl(2). 


The named file is opened unless one or more of the 
following are true: 


’ 
to 
' 


ENOTDIR] 
ENOENT] 
EACCES] 
EACCES] 
EISDIR] 


EROFS|] 


EMFILE] 


ENXIO] 


[ETXTBSY] 


{EFAULT] 
{EEXIST] 


ENXIO] 


EINTR] 


ENFILE] 
EDEADLOCK| 


RETURN VALUE 
Upon successful completion, the file descriptor is 
returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
a close(2), shee dup(2), fentl(2), locking(2), 
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, read(2), umask(2 
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A component of the path prefix is not a 
directory. 


O_CREAT is not set and the named file 
does not exist. 


A component of the path prefix denies 
search permission. 


Oflag permission is denied for the 
named file. 


The named file is a directory and oflag 
is write or read/write. 


The named file resides on a read-only 
file system and oflag is write or 
read/write. 


Twenty (20) file descriptors are 
currently open. 


The named file is a character special or 
block special file, and the device 
associated with this special file does not 
exist. 


The file is a pure procedure (shared 
text) file that is being executed and 
oflag is write or read/write. 


Path points outside the allocated 
address space of the process. 


O_CREAT and O_EXCL are set, and the 
named file exists. 


O_NDELAY is set, the named file is a 
FIFO, O_WRONLY is set, and no process 
has the file open for reading. 


A signal was caught during the open 
system call. 


The system file table is full. 


A side effect of a previous locking(2) 
call, when applying O_TRUNC . 


, write(2). 


OPENI( 2) 


NAME 
openi — open a file specified by i-node 


ae SYNOPSIS 


#include <sys/types.h> 
#include <fentl.h> 


int openi (dev, inode, oflag) 
dev_t dev; 

ino_t inode; 

int oflag; 


DESCRIPTION 


Opent permits access to a file without reference to any 
of its directory links. Because it doesn’t use the 
directory hierarchy, opent doesn’t require any access 
permission except from the file itself. Use of opent must 
be authorized in advance by syslocal(2). 


Dev specifies the device number of the file system that 
contains the file. IJnode is the i-number of the file. 
Oflag is a set of open flags, identical to those used with 
open(2). The return value is a file descriptor, like that 
returned by open. 


A file descriptor returned by opent has the same 
properties as one returned by open. It counts against 
the per-process limit of 20 file descriptors. 


The specified file is opened unless one or more of the 
following are true: 


The specified inode is not allocated. [ENOENT] 


Oflag permission is denied for the named file. 
[EACCES| 


The named file is a directory. [EISDIR] 


The named file resides on a read-only file system 
and oflag is write or read/write. [EROFS| 
Twenty (20) file descriptors are currently open. 
[EMFILE] 

The named file is a character special or block 
special file. [ENXIO] 


The file is a pure procedure (shared text) file 
that is being executed and oflag is write or 
read/write. [ETXTBSY] 


Path points outside the process’s allocated 
address space. [EFAULT] 


O_CREAT and O_EXCL are set, and the named 
file exists. [EEXIST] 


eo Be 
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O_NDELAY is set, the file is a FIFO, O_.WRONLY 
is set, and no process has the file open for 
reading. [ENXIO} 
The specified file system is not mounted. 
(ENXIO} 

RETURN VALUE 


On success, returns a file descriptor, a nonnegative 
integer. On failure, returns —1 and sets errno. 


SEE ALSO 
creat(2), open(2), syslocal(2). 


PAUSE(2) 


NAME 

pause — suspend process until signal 
SYNOPSIS 

pause () 
DESCRIPTION 


Pause suspends the calling process until it receives a 
signal. The signal must be one that is not currently set 
to be ignored by the calling process. 


If the signal causes termination of the calling process, 
pause will not return. 


If the signal is caught by the calling process and control 
is returned from the signal-catching function (see 
signal(2)), the calling process resumes execution from the 
point of suspension; with a return value of —1 from 
pause and errno set to EINTR. 


SEE ALSO 
alarm(2), kill(2), signal(2), wait(2). 
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NAME 
pipe — create an interprocess channel 


SYNOPSIS 
int pipe (fildes) 
int fildes|2); 
DESCRIPTION 
Pipe creates an I/O mechanism called ah hf and returns 


two file descriptors, sine and fildes Fildes {0} is 
opened for reading and fildes We is opened for writing. 


Up to 9K bytes of data are buffered by the pipe before 
the writing process is blocked. A _ read only file 
descriptor fildes|0| accesses the data written to fildes(1) 
on a first-in-first-out (FIFO) basis. 


[EMFILE] Pipe will fail if 19 or more file 
descriptors are currently open. 
[ENFILE] The system file table is full. 
RETURN VALUE 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
sh(1), read(2), write(2). 
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NAME 


PLOCK (2) 


plock — lock process, text, or data in memory 


SYNOPSIS 


#include <sys/lock.h> 


int plock (op) 
int op; 


DESCRIPTION 


Plock allows the calling process to lock its text segment 
(text lock), its data and stack segments (data lock), or 
both its text and data segments (process lock) into 
memory. Locked segments are immune to all routine 
swapping. Plock also allows these segments to be 
unlocked. For 407 object modules TXTLOCK and 
DATLOCK are identical. The effective user ID of the 
calling process must be super-user to use this call. Op 
specifies the following: 


PROCLOCK lock text and data segments into 
memory (process lock) 


TXTLOCK lock text segment into memory (text 


lock) 

DATLOCK lock data segment into memory (data 
lock) 

UNLOCK remove locks 


Shared regions (e.g., text) may be locked by anyone 
using the text, but they may be unlocked only if the 
caller is the last one using the region. Note that sticky- 
bit text that is not explicitly unlocked will remain locked 
in core even after the last process using it terminates. 


Plock will fail and not perform the requested operation if 
one or more of the following are true: 


[EPERM] The effective user ID of the calling 
process is not super-user. 
[EINVAL Op is equal to PROCLOCK and a 


process lock, a text lock, or a data lock 
already exists on the calling process. 


[EINVAL Op is equal to TXTLOCK and a text 
lock, or a process lock already exists on 
the calling process. 


|EINVAL Op is equal to DATLOCK and a data 
lock, or a process lock already exists on 
the calling process. 


[EINVAL Op is equal to UNLOCK and no type of 
lock exists on the calling process. 


Base 
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RETURN VALUE 
Upon successful completion, a value of 0 is returned to 
the calling process. Otherwise, a value of —1 is returned 
and errno is set to indicate the error. 


SEE ALSO 
exec(2), exit(2), fork(2). 
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NAME 


PROFIL (2) 


profil — execution time profile 


SYNOPSIS 


void profil (buff, bufsiz, offset, scale) 
char *buff; 
int bufsiz, ‘offset, scale; 


DESCRIPTION 


Buff points to an area of core whose length (in bytes) is 
given by bufetz. After this call, the user’s program 
counter (pc) is examined each clock tick (60th second); 
offset is subtracted from it, and the result multiplied by 
scale. Jf the resulting number corresponds to a word 
inside buff, that word is incremented. 


The scale is interpreted as an unsigned, fixed-point 
fraction with binary point at the left: 0177777 (octal) 
ives a 1-1 mapping of pc’s to words in buff; 077777 
(octal) maps each pair of instruction words together. 
02(octal) maps all instructions onto the beginning of buff 
(producing a non-interrupting core clock). 


Profiling is turned off by giving a scale of 0 or 1. It is 
rendered ineffective by giving a bufstz of 0. Profiling is 
turned off when an ezec is executed, but remains on in 
child and parent both after a fork. Profiling will be 
turned off if an update in buff would cause a memory 
fault. 


RETURN VALUE 


Not defined. 


SEE ALSO 


prof(1), monitor(3C). 


NAME 


PTRACE(2) 


ptrace — process trace 


SYNOPSIS 


int ptrace (request, pid, addr, data); 
int request, pid, addr, data; 


DESCRIPTION 


Ptrace provides a means by which a parent process may 
control the execution of a child process. Its primary use 
is for the implementation of breakpoint debugging; see 
sdb(1). The child process behaves normally until it 
encounters a signal (see stgnal(2) for the list), at which 
time it enters a stopped state and its parent is notified 
via watt(2). When the child is in the stopped state, its 
parent can examine and modify its “core image’’ using 
ptrace. Also, the parent can cause the child either to 
terminate or continue, with the possibility of ignoring 
the signal that caused it to stop. 


The request argument determines the precise action to 
be taken by ptrace and is one of the following: 


0 This request must be issued by the child process if 
it is to be traced by its parent. It turns on the 
child’s trace flag that stipulates that the child 
should be left in a stopped state upon receipt of a 
signal rather than the state specified by func; see 
signal(2). The pid, addr, and data arguments are 
ignored, and a return value is not defined for this 
request. Peculiar results will ensue if the parent 
does not expect to trace the child. 


The remainder of the requests can only be used by the 
parent process. For each, ptd is the process ID of the 
child. The child must be in a stopped state before these 
requests are made. 


1,2 With these requests, the word at location addr in 
the address space of the child is returned to the 
parent process. If I and D space are separated (as 
on PDP-11s), request 1 returns a word from I space, 
and request 2 returns a word from D space. If I 
and D space are not separated (as on Convergent 
Technologies 68000-family processors), either 
request 1 or request 2 may be used with equal 
results. The data argument is ignored. These two 
requests will fail if addr is not the start address of 
a word, in which case a value of —1 is returned to 
the parent process and the parent’s errno is set to - 
EIO. 
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With this request, the word at location addr in the 
child’s USER area in the system’s address space (see 
<sys/user.h>) is returned to the parent process. 
Addresses in this area range from 0 to USIZE on 
Convergent Technologies 68000-family processors. 
The data argument is ignored. This request will 
fail if addr is not the start address of a word or is 
outside the USER area, in which case a value of —1 
is returned to the parent process and the parent’s 
errno is set to ElO. 


With these requests, the value given by the data 
argument is written into the address space of the 
child at location addr. If I and D space are 
separated (as on PDP-I1s), request 4 writes a word 
into I space, and request 5 writes a word into D 
space. If I and D space are not separated (as on 
Convergent Technologies 68000-family processors), 
either request 4 or request 5 may be used with 
equal results. Upon successful completion, the 
value written into the address space of the child is 
returned to the parent. These two requests will fail 
if addr is a location in a pure procedure space and 
another process is executing in that space, or addr 
is not the start address of a word. Upon failure a 
value of -1 is returned to the parent process and 
the parent’s errno is set to EIO. 


With this request, a few entries in the child’s USER 
area can be written. Data gives the value that is 
to be written and addr is the location of the entry. 
The few entries that can be written are: 


the general registers (i.e., registers 0 to 15 
on Convergent Technologies 68000-family 
processors). 


all processor status bits except 8, 9, 10, 12, 
and 13 


This request causes the child to resume execution. 
If the data argument is 0, all pending signals 
including the one that caused the child to stop are 
canceled before it resumes execution. If the data 
argument is a valid signal number, the child 
resumes execution as if it had incurred that signal, 
and any other pending signals are canceled. The 
addr argument must be equal to 1 for this request. 
Upon successful completion, the value of data is 
returned to the parent. This request will fail if 
data is not 0 or a valid signal number, in which 
case a value of —1 is returned to the parent process 
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and the parent’s errno is set to EIO. 


This request causes the child to terminate with the 
same consequences as eztt(2). 


This request sets the trace bit in the Processor 
Status Word of the child (ie., bit 15 on 
Convergent Technologies 68000-family processors) 
and then executes the same steps as listed above 
for request 7. The trace bit causes an interrupt 
upon completion of one machine instruction. This 
effectively allows single stepping of the child. 


To forestall possible fraud, ptrace inhibits the set-user-id 
facility on subsequent ezec(2) calls. If a traced process 


calls 


exec, it will stop before executing the first 


instruction of the new image showing signal SIGTRAP. 


GENERAL ERRORS 
Ptrace will in general fail if one or more of the following 


are true: 
[EIO] Request is an illegal number. 
[ESRCH] Pid identifies a child that does not exist 


FILES 


or has not executed a ptrace with 
request O. 


/usr/include/sys/page.h 
/usr/include/sys/user.h 


SEE ALSO 


exec(2), signal(2), wait(2). 
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NAME 


READ (2) 


read — read from file 


SYNOPSIS 


int read (fildes, buf, nbyte) 
int fildes; 

char *buf; 

unsigned nbyte; 


DESCRIPTION 


Fildes is a file descriptor obtained from a creat, open, 
dup, fentl, or pipe system call. 


Read attempts to read nbyte bytes from the file 
associated with fildes into the buffer pointed to by buf. 


On devices capable of seeking, the read starts at a 
position in the file given by the file pointer associated 
with fildes. Upon return from read, the file pointer is 
incremented by the number of bytes actually read. 


Devices that are incapable of seeking always read from 
the current position. The value of a file pointer 
associated with such a file is undefined. 


Upon successful completion, read returns the number of 
bytes actually read and placed in the buffer; this number 
may be less than nbyte if the file is associated with a 
communication line (see toctl(2) and termto(7)), or if the 
number of bytes left in the file is less than nbyte bytes. 
A value of 0 is returned when an end-of-file has been 
reached. 


When attempting to read from an empty pipe (or FIFO): 
If O_NDELAY is set, the read will return a 0. 


If O_NDELAY is clear, the read will block until 
data is written to the file or the file is no longer 
open for writing. 


When attempting to read a file associated with a tty 
that has no data currently available: 


If O_NDELAY is set, the read will return a 0. 


If OLNDELAY is clear, the read will block until 
data becomes available. 


Read will fail if one or more of the following are true: 


[EBADF} Fildes is not a valid file descriptor open 
for reading. 

[EFAULT] Buf points outside the allocated address 
space. 


READ (2) 


[EINTR] A signal was caught during the read 
system call. 


|EDEADLOCK] A side effect of a previous locking(2) 
call. 

RETURN VALUE 
Upon successful completion a non-negative integer is 
returned indicating the number of bytes actually read. 
Otherwise, a -1 is returned and errno is set to indicate 
the error. 

SEE ALSO 


reat), dup(2), fentl(2), ioctl(2), locking(2), open(2), 
pipe(2), termio(7). 


RECV(2N) 


NAME 
recv, recvfrom — receive a message from a socket 


as SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


recv(s, buf, len, flags) 
int 5; 

char *buf; 

int len, flags; 


recvfrom(s, buf, len, flags, from, fromlen) 
int 8; 

char *buf; 

int len, flags; 

struct sockaddr “from; 

int *fromlen; 


DESCRIPTION 
Recv and recvfrom are used to receive messages from a 
socket. 


The recv call may be used only on a connected socket 
(see connect(2)), while recufrom may be used to receive 

~ data on a socket whether it is in a connected state or 
not. 


If from is non-zero, the source address of the message is 
filled in. Fromlen is a value-result parameter, initialized 
to the size of the buffer associated with from, and 
modified on return to indicate the actual size of the 
address stored there. The length of the message is 
returned in cc. If a message is too long to fit in the 
supplied buffer, excess bytes may be discarded depending 
on the type of socket the message is received from; see 
socket(2). 


If no messages are available at the socket, the receive 
call waits for a message to arrive. 


The flags argument to a send call is formed by or’ing 
one or more of the values: 


#defineMSG_PEEK  Oxl 

/* peek at incoming message */ 
#define MSG_OOB 0x2 

/* process out-of-band data */ 


RETURN VALUE 
These calls return the number of bytes received, or ~1 if 
an error occurred. 

ERRORS 
The calls fail if: 


[EBADF] 


[ENOTSOCK] 
(EINTR] 


(EFAULT] 


SEE ALSO 


RECV(2N) 


The argument ¢s is an invalid 
descriptor. 


The argument s is not a socket. 


The receive was interrupted by 
delivery of a signal before any 
data was available for the receive. 


The data was specified to be 
received into a non-existent or 
protected part of the process 
address space. 


connect(2N), read(2), send(2), socket(2N). 
CTIX Internetworking Manual. 


NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


SEMCTL (2) 


NAME 
semctl — semaphore control operations 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipe.h> 
#include <sys/sem.h> 


int semctl (semid, semnum, cmd, arg) 
int semid, emd; 
int semnum; 
union semun { 
int val; 
struct semid_ds *buf; 
ushort *array; 
} arg; 
DESCRIPTION 
Semctl provides a variety of semaphore control 
operations as specified by emd. 


The following emds are executed with respect to the 

semaphore specified by semtd and semnum: 

GETVAL Return the value of semval (see tntro(2)). 
{READ} 

SETVAL Set the value of semval to arg.val. 
{ALTER} When this cmd is successfully 
executed, the semadj value corresponding 
to the specified semaphore in all processes 
is cleared. 

GETPID Return the value of sempid. {READ} 

GETNCNT Return the value of semnent. {READ} 

GETZCNT _ Return the value of semzcnt. {READ} 


The following emds return and set, respectively, every 
semval in the set of semaphores. 


GETALL Place semvals into array pointed to by 
arg.array. {READ} 


SETALL Set semvals according to the array 
pointed to by arg.array. {ALTER} When 
this cmd is successfully executed the 
semadj values corresponding to each 
specified semaphore in all processes are 
cleared. 


The following emds are also available: 


IPC_STAT Place the current value of each member 
of the data structure associated with 
semid into the structure pointed to by 


a tee 


IPC_SET 
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arg.buf. The contents of this structure 
are defined in tntro(2). {READ} 


Set the value of the following members of 
the data structure associated with semid 
to the corresponding value found in the 
structure pointed to by arg.buf: 
sem_perm.uid 

sem_perm.gid 

sem_perm.mode /* only low 9 bits */ 


This cmd can only be executed 
by a process that has an effective 
user ID equal to either that of 
super-user or to the value of 
sem_perm.uid in the data 
structure associated with semid. 


IPC_RMID Remove the semaphore 
identifier specified by 
semtd from the system and 
destroy the set of 
semaphores and data 
structure associated with 
it. This cmd can only be 
executed by a process that 
has an effective user ID 
equal to either that of 
super-user or to the value 
of sem_perm.uid in the 
data structure associated 
with semid. 


Semctl will fail if one or more of the 
following are true: 


EINVAL] Semtd is not a _ valid 
semaphore identifier. 

EINVAL} Semnum is less than zero 
or greater than 
sem_nsems. 

EINVAL] Cmd is not a valid 
command. 

EACCES} Operation permission is 
denied to the calling 
process (see intro(2)). 

ERANGE] Cmd is SETVAL or 


SETALL and the value 
to which semval is to be 
set is greater than the 
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system imposed 
maximum. 
[EPERM] Cmd is equal _ to 


IPC_RMID or IPC_SET 
and the effective user ID 
of the calling process is 
not equal to that of 
super-user and it is not 
equal to the value of 
sem_perm.uid in the 
data structure associated 
with semid. 


{(EFAULT] Arg.buf points to an 
illegal address. 


RETURN VALUE 
Upon successful completion, the value returned depends 
on cmd as follows: 


GETVAL The value of semval. 
GETPID The value of sempid. 
GETNCNT The value of semncnt. 
GETZCNT The value of semzcnt. 
All others A value of 0. 


Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
intro(2), semget(2), semop(2). 


SEMGET (2) 


NAME 
semget — get set of semaphores 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semget (key, nsems, semflg) 
key_t key; 
int nsems, semflg; 

DESCRIPTION 
Semget returns the semaphore identifier associated with 
key. 
A semaphore identifier and associated data structure and 
set containing nsems semaphores (see intro(2)) are 
created for key if one of the following are true: 


Key is equal to IPC_PRIVATE. 


Key does not already have a semaphore 
identifier associated with it, and (semflg & 
IPC_CREAT) is “‘true”’. 


Upon creation, the data structure associated with the 
new semaphore identifier is initialized as follows: 


Sem_perm.cuid, sem_perm.uid, 
sem_perm.cgid, and sem_perm.gid are set 
equal to the effective user ID and effective group 
ID, respectively, of the calling process. 


The low-order 9 bits of sem_perm.mode are 
set equal to the low-order 9 bits of semflg. 


Sem_nsems is set equal to the value of nsems. 


Sem_otime is set equal to 0 and sem_ctime is 
set equal to the current time. 


Semget will fail if one or more of the following are true: 


EINVAL] Neems is either less than or equal to 
zero or greater than the system-imposed 
limit. 

EACCES] A semaphore identifier exists for key, 


but operation permission (see intro(2)) 
as specified by the low-order 9 bits of 
semflg would not be granted. 


EINVAL] A semaphore identifier exists for key, 
but the number of semaphores in the 
set associated with it is less than nsems 
and nsems is not equal to zero. 


[ENOENT] 


[ENOSPC] 


[ENOSPC} 


{EEXIST] 


RETURN VALUE 


Upon successful 
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A semaphore identifier does not exist 
for key and (semflg & IPC_CREAT) is 
“false’’. 


A semaphore identifier is to be created 
but the system-imposed limit on the 
maximum number of allowed semaphore 
identifiers system wide would _ be 
exceeded. 


A semaphore identifier is to be created 
but the system-imposed limit on the 
maximum number of allowed 
semaphores system wide would be 
exceeded. 


A semaphore identifier exists for key 
but (sewiitg & IPC_CREAT) and 
(semflg& IPC_EXCL) ) is “‘true’’. 


completion, a non-negative integer, 


namely a semaphore identifier, is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the 


error. 
SEE ALSO 


intro(2), semctl(2), semop(2). 


NAME 


SEMOP (2) 


semop — semaphore operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipce.h> 
#include <sys/sem.h> 


int semop (semid, sops, nsops) 
int semid; 

struct sembuf **sops; 

int nsops; 


DESCRIPTION 


Semop is used to atomically perform an array of 
semaphore operations on the set of semaphores 
associated with the semaphore identifier specified by 
semid. Sops is a pointer to the array of semaphore- 
operation structures. Nesops is the number of such 
structures in the array. The contents of each structure 
includes the following members: 


short sem_num; /* semaphore number */ 
short sem_op; /* semaphore operation */ 
short sem_flg; /* operation flags */ 


Each semaphore operation specified by sem_op is 
performed on the corresponding semaphore specified by 
semid and sem_num. 


Sem_op specifies one of three semaphore operations as 
follows: 


If sem_op is a negative integer, one of the 
following will occur: {ALTER} 


If semval (see tntro(2)) is greater than 
or equal to the absolute value of 
sem_op, the absolute value of sem_op 
is subtracted from semval. Also, if 
(sem_flg & SEM_UNDO) is “‘true’’, the 
absolute value of sem_op is added to 
the calling process’s semadj value (see 
ezit(2)) for the specified semaphore. 
All processes suspended waiting for 
semval are rescheduled. 


If semval is less than the absolute value 
of sem_op and (sem_flg & 
IPC_NOWAIT) is “true”, semop will 
return immediately. 


If semval is less than the absolute value 
of sem_op and (sem_flg & 
IPC_NOWAIT) is “false”, semop will 
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increment the semncnt associated with 
the specified semaphore and suspend 
execution of the calling process until 
one of the following conditions occurs: 


Semval becomes greater than or 
equal to the absolute value of 
sem_op. When this occurs, the 
value of semncnt associated with the 
specified semaphore is decremented, 
the absolute value of sem_op is 
subtracted from semval and, if 
(sem_flg & SEM_UNDO) is “‘true”’, 
the absolute value of sem_op is 
added to the calling process’s semadj 
value for the specified semaphore, 
and all the operations are tried 
again. 

The semid for which the calling 
process is awaiting action is removed 
from the system (see semctl(2)). 
When this occurs, errno is set equal 
to EIDRM, and a value of —1 is 
returned. 


The calling process receives a signal 
that is to be caught. When this 
occurs, the value of semncent 
associated with the specified 
semaphore is decremented, and the 
calling process resumes execution in 
the manner prescribed in signal(2). 
If sem_op is a positive integer, the value of 
sem_op is added to semval and, if (sem_fig & 
SEM_UNDO) is “‘true’’, the value of sem_op is 
subtracted from the calling process’s semadj 
value for the specified semaphore. {ALTER} 


If sem_op is zero, one of the following will 
occur: {READ} 
If semval is zero, semop will return 
immediately. 


If semval is not equal to zero and 
(sem_flg & IPC_NOWAIT) is ‘“‘true’’, 
semop will return immediately. 


If semval is not equal to zero and 
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(sem_flg & IPC_NOWAIT) is “‘false’’, 
semop will increment the semzcnt 
associated with the specified semaphore 
and suspend execution of the calling 
process until one of the following 
occurs: 


Semval becomes zero, at which time 
the value of semzcnt associated with 
the specified semaphore is 
decremented. 


The semid for which the calling 
process is awaiting action is removed 
from the system. When this occurs, 
errno is set equal to EIDRM, and a 
value of —1 is returned. 


The calling process receives a signal 
that is to be caught. When this 
occurs, the value of semzcnt 
associated with the — specified 
semaphore is decremented, and the 
calling process resumes execution in 
the manner prescribed in stgnal(2). 


Semop will fail if one or more of the following are true 
for any of the semaphore operations specified by sops: 


[EINVAL] 


[EFBIG] 


E2BIG] 
EACCES| 


EAGAIN} 


ENOSPC] 


EINVAL] 


Semtd is not a valid semaphore 
identifier. 


Sem_num is less than zero or greater 
than or equal to the number of 
semaphores in the set associated with 
semid. 


Nsops is greater than the system- 
imposed maximum. 


Operation permission is denied to the 
calling process (see intro(2)). 


The operation would result in 
suspension of the calling process but 
(sem_flg & IPC_NOWAIT) is “‘true’’. 


The limit on the number of individual 
processes requesting an SEM_UNDO 
would be exceeded. 


The number of individual semaphores 
for which the calling process requests a 
SEM_UNDO would exceed the limit. 
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[ERANGE] An operation would cause a semval to 
overflow the system-imposed limit. 

[ERANGE] An operation would cause a semadj 
value to overflow the system-imposed 
limit. 

[EFAULT] Sops points to an illegal address. 


Upon successful completion, the value of sempid for each 
semaphore specified in the array pointed to by sops is set 
equal to the process ID of the calling process. 


RETURN VALUE 
If semop returns due to the receipt of a signal, a value of 
—1 is returned to the calling process and errno is set to 
EINTR. If it returns due to the removal of a semid from 
the system, a value of —1 is returned and errno is set to 
EIDRM. 


Upon successful completion, the value of semval at the 
time of the call for the last operation in the array 
pointed to by sops is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 


SEE ALSO 
exec(2), exit(2), fork(2), intro(2), semctl(2), semget(2). 


SEND (2N) 


NAME 
send, sendto — send a message to a socket 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


send(s, msg, len, flags) 

int s; 

char *msg; 

int len, flags; 

sendto(s, msg, len, flags, to, tolen) 
int 8; 

char “msg; 

int len, flags; 

struct sockaddr “to; 

int tolen; 


DESCRIPTION 
Send and sendto are used to transmit a message to 
another socket (s). Send may be used only when the 
socket is in a connected state, while sendto may be used 
at any time. 


The address of the target is given by to with tolen 
specifying its size. The length of the message is given by 
len. If the message is too long to pass atomically 
through the underlying protocol, then the error 
EMSGSIZE is returned, and the message is not 
transmitted. 


No indication of failure to deliver is implicit in a send. 
Return values of -—1 indicate some locally detected 
errors. 


If no message space is available at the socket to hold the 
message to be transmitted, then send blocks. 


The flags parameter may be set to SOF_OOB to send 
out-of-band data on sockets which support this notion 
(e.g., SOCK_STREAM). 

RETURN VALUE 
The call returns the number of characters sent, or —1 if 
an error occurred. 


ERRORS 
[EBADF} An invalid = descriptor was 
specified. 
[(ENOTSOCK|] The argument s is not a socket. 
[EFAULT] An invalid user space address was 


specified for a parameter. 


SEND (2N) 


[EMSGSIZE] The socket requires that message 
be sent atomically, and the size of 
the message to be sent made this 
impossible. 

SEE ALSO 

recv(2N), socket(2N). 

CTIX Internetworking Manual. 
NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 
setpgrp — set process group ID 


SETPGRP (2) 


SYNOPSIS 


int setpgrp ( ) 


DESCRIPTION 


Setpgrp sets the process group ID of the calling process to 
the process ID of the calling process and returns the 


process group ID. 


RETURN VALUE 


Setpgrp returns the value of the process group ID. 


SEE ALSO 


NOTE 


exec(2), fork(2), getpid(2), intro(2), kill(2), signal(2). 


This function is incorrectly documented in the UNIX 
System V_ Interface definition and other UNIX 
documentation. The description here accurately 
describes the system call. 


_— 


NAME 


SETUID(2) 


setuid, setgid — set user and group IDs 


SYNOPSIS 


int setuid (uid) 
int uid; 
int setgid (gid) 
int gid; 


DESCRIPTION 


Setuid (setgid) is used to set the real user (group) ID and 
effective user (group) ID of the calling process. 


If the effective user ID of the calling process is super- 
user, the real user (group) ID and effective user (group) 
ID are set to uid (gid). 


If the effective user ID of the calling process is not 
super-user, but its real user (group) ID is equal to utd 
(gtd), the effective user (group) ID is set to utd (gid). 


If the effective user ID of the calling process is not 
super-user, but the saved set-user (group) ID from ezec(2) 
is equal to utd (gid), the effective user (group) ID is set to 
utd (gtd). 

Setuid (setgid) will fail if the real user (group) ID of the 
calling process is not equal to utd (gid) and its effective 
user ID is not super-user. [EPERM] 


The utd is out of range. [EINVAL] 


RETURN VALUE 


Upon successful completion, a value of O is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


getuid(2), intro(2). 


NAME 


SHMCTL(2) 


shmctl — shared memory control operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#tinclude <sys/shm.h> 


int shmctl (shmid, emd, buf) 
int shmid, emd; 
struct shmid_ds *buf; 


DESCRIPTION 


Shmetl provides a variety of shared memory control 
operations as specified by emd. The following emds are 


available: 


IPC_STAT Place the current value of each member of 


IPC_SET 


SHM_LOCK 


the data structure associated with shmid 
into the structure pointed to by buf. The 
contents of this structure are defined in 
[EINVAL] tntro(2). {READ} 


Set the value of the following members of 
the data structure associated with shmid to 
the corresponding value found in the 
structure pointed to by buf: 

shm_perm.uid 

shm_perm.gid 

shm_perm.mode /* only low 9 bits */ 


This cmd can only be executed by a process 
that has an effective user ID equal to either 
that of super-user or to the value of 
shm_perm.uid in the data structure 
associated with shmied. 


Lock the shared memory segment 
specified by shmtd in memory. This 
emd can only be executed by a process 
that has an effective user ID equal to 
super user. 


SHM_UNLOCK 


IPC_RMID 


Unlock the shared memory segment 
specified by shmtd. This emd can only 
be executed by a process that has an 
effective user ID equal to super user. 


Remove the shared memory identifier 
specified by shmtd from the system and 
destroy the shared memory segment 
and data structure associated with it. 
This emd can only be executed by a 
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process that has an effective user ID 
equal to either that of super-user or to 
the value of shm_perm.uid in the 
data structure associated with shmid. 


Shmetl will fail if one or more of the following are true: 


EINVAL] 


[EINVAL] 
EACCES| 


EPERM| 


[EPERM] 


[EINVAL] 


[EFAULT 
RETURN VALUE 


Shmid is not a valid shared memory 
identifier. 


Cmd is not a valid command. 


Cmd is equal to IPC_STAT and 
{READ} operation permission is denied 
to the calling process (see intro(2)). 


Cmd is equal to IPC_RMID or 
IPC_SET and the effective user ID of 
the calling process is not equal to that 
of super user and it is not equal to the 
value of shm_perm.uid in the data 
structure associated with shmid. 


Cmd is equal to SHM_LOCK or 
SHM_UNLOCK and the effective user 
ID of the calling process is not equal to 
that of super user. 


Cmd is equal to SHM_UNLOCK and 
the shared-memory segment specified 
by shmid is not locked in memory. 


Buf points to an illegal address. 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


intro(2), shmget(2), shmop(2). 


SHMGET (2) 


NAME 
shmget — get shared memory segment 


SYNOPSIS 
#finclude <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 


int shmget (key, size, shmflg) 
key_t key; 
int size, shmfig; 


DESCRIPTION 


Shmget returns the shared memory identifier associated 
with key. 


A shared memory identifier and associated data structure 
and shared memory segment of size size bytes (see 
intro(2)) are created for key if one of the following are 
true: 


Key is equal to IPC_PRIVATE. 


Key does not already have a shared memory 
identifier associated with it, and (shmflg & 
IPC_CREAT) is “‘true”’. 


Upon creation, the data structure associated with the 
new shared memory identifier is initialized as follows: 


Shm_perm.cuid, shm_perm.uid, 
shm_perm.cgid, and shm_perm.gid are set 
equal to the effective user ID and effective group 
ID, respectively, of the calling process. 


The low-order 9 bits of shm_perm.mode are 
set equal to the low-order 9 bits of shmflg. 
Shm_segsz is set equal to the value of size. 
Shm_Ipid, shm_nattch, shm_atime, and 
shm_dtime are set equal to 0. 


Shm_ctime is set equal to the current time. 
Shmget will fail if one or more of the following are true: 


{EINVAL} Size is less than the system-imposed 
minimum or greater than the system- 
imposed maximum. 

[EACCES}] A shared memory identifier exists for 
key but operation permission (see 
intro(2)) as specified by the low-order 9 
bits of shmflg would not be granted. 

[EINVAL] A shared memory identifier exists for 


key but the size of the segment 
associated with it is less than size and 
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stze is not equal to zero. 


[ENOENT] A shared memory identifier does not 
exist for key and (shmflg & 
IPC_CREAT) is “‘false”’. 


[ENOSPC| A shared memory identifier is to be 
created but the system-imposed limit on 
the maximum number of allowed shared 
memory identifiers system wide would 
be exceeded. 


[ENOMEM] A shared memory identifier and 
associated shared memory segment are 
to be created but the amount of 
available physical memory is _ not 
sufficient to fill the request. 


[EEXIST] A shared memory identifier exists for 
key but ( (shmflg & IPC_CREAT) and 
( shmflg & IPC_EXCL) ) is “‘true’’. 


RETURN VALUE 
Upon successful completion, a non-negative integer, 
namely a shared memory identifier is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
intro(2), shmctl(2), shmop(2). 


SHMOP (2) 


NAME 
shmop ~ shared memory operations 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 


char *shmat (shmid, shmaddr, shmfig) 
int shmid; 

char *shmaddr 

int shmfilg; 


int shmdt (shmaddr) 
char *shmaddr 


DESCRIPTION 
Shmat attaches the shared memory segment associated 
with the shared memory identifier specified by shmid to 
the data segment of the calling process. The segment is 
attached at the address specified by one of the following 
criteria: 
If shmaddr is equal to zero, the segment is 
attached at the first available address as selected 
by the system. 


If shmaddr is not equal to zero and (shmflg & 
SHM_RND) is “‘true’’, the segment is attached 
at the address given by (shmaddr - (shmaddr 
modulus SHMLBA)). 


If shmaddr is not equal to zero and (shmflg & 
SHM_RND) is “false”, the segment is attached 
at the address given by shmaddr. 
The segment is attached for reading if (shmflg & 
SHM_RDONLY) is “true” {READ}, otherwise it is 
attached for reading and writing {READ/WRITE}. 


Shmat will fail and not attach the shared memory 
segment if one or more of the following are true: 


EINVAL] Shmid is not a valid shared memory 
identifier. 

EACCES] Operation permission is denied to the 
calling process (see tntro(2)). 

ENOMEM| The available data space is not large 
enough to accommodate the shared 
memory segment. 

EINVAL] Shmaddr is not equal to zero, and the 


value of (shmaddr - (shmaddr modulus 
SHMLBA)) is an illegal address. 


[EINVAL] 


[EMFILE] 


[EINVAL] 


[EINVAL] 


RETURN VALUES 
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Shmaddr is not equal to zero, (shmflg & 
SHM_RND) is “false’’, and the value of 
shmaddr is an illegal address. 


The number of shared memory 
segments attached to the calling process 
would exceed the system-imposed limit. 


Shmdt detaches from the calling 
process’s data segment the shared 
memory segment located at the address 
specified by shmaddr. 


Shmdt will fail and not detach the 
shared memory segment if shmaddr is 
not the data segment start address of a 
shared memory segment. 


Upon successful completion, the return value is as 


follows: 


Shmat returns the data segment start address of 
the attached shared memory segment. 


Shmdt returns a value of 0. 


Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


exec(2), exit(2), fork(2), intro(2), shmctl(2), shmget(2). 


SHUTDOWN (2N) 


NAME 
shutdown — shut down part of a full-duplex connection 


SYNOPSIS 
shutdown(s, how) 
int s, how; 


DESCRIPTION 
The shutdown call causes all or part of a full-duplex 
connection on the socket associated with s to be shut 
down. If how is 0, then further receives will be 
disallowed. If how is 1, then further sends will be 
disallowed. If how is 2, then further sends and receives 
will be disallowed. 


DIAGNOSTICS 

A 0 is returned if the call succeeds, —1 if it fails. 
ERRORS 

The call succeeds unless: 

[EBADF] S is not a valid descriptor. 


[ENOTSOCK] Sis a file, not a socket. 
[ENOTCONN] The specified socket is not connected. 


SEE ALSO 
connect(2N), socket(2N). 
CTIX Internetworking Manual. 


NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NOTES 


SSIGNAL(3C ) 


There are some additional signals with numbers outside 
the range 1 through 15 which are used by the Standard 
C Library to indicate error conditions. Thus, some 
signal numbers outside the range 1 through 15 are legal, 
although their use may interfere with the operation of 
the Standard C Library. 


NAME 


STDIO(3S) 


stdio — standard buffered input/output package 


SYNOPSIS 


#include <stdio.h> 
FILE *stdin, *stdout, *stderr; 


DESCRIPTION 


The functions described in the entries of sub-class 3S of 
this manual constitute an efficient, user-level 1/0 
buffering scheme. The in-line macros getc(3S) and 
putc(3S) handle characters quickly. The macros getchar 
and putchar, and the higher-level routines fgetc, fgets, 
fprintf, fputc, fputs, fread, fecanf, fwrite, gets, getw, 
printf, puts, putw, and scanf all use or act as if they use 
getc and putc; they can be freely intermixed. 


A file with associated buffering is called a stream and is 
declared to be a pointer to a defined type FILE. 
Fopen(3S) creates certain descriptive data for a stream 
and returns a pointer to designate the stream in all 
further transactions. Normally, there are three open 
streams with constant pointers declared in the 
<stdio.h> header file and associated with the standard 
open files: 


stdin standard input file 
stdout _— standard output file 
stderr standard error file 


A constant NULL (0) designates a nonexistent pointer. 


An integer-constant EOF (-1) is returned upon end-of- 
file or error by most integer functions that deal with 
streams (see the individual descriptions for details). 


An integer constant BUFSIZ specifies the size of the 
buffers used by the particular implementation. 


Any program that uses this package must include the 
header file of pertinent macro definitions, as follows: 


#include <stdio.h> 


The functions and constants mentioned in the entries of 
sub-class 3S of this manual are declared in that header 
file and need no further declaration. The constants and 
the following “functions” are implemented as macros 
(redeclaration of these names is perilous): getc, getchar, 
pute, putchar, ferror, feof, clearerr, and fileno. 


SEE ALSO 


open(2), close(2), Iseek(2), pipe(2), rena). write(2), 
ctermid(3S), cuserid(3S), felose(3S), ferror(3S), fopen 38), 
fread(3S), fseek(3S), getc(3S), se popen 38), 
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printf(3S), putc(3S), puts(3S), scanf(3S), setbuf(3S), 
system(3S), tmpfile(3S), tmpnam(3S), ungetc(3S). 


—_ DIAGNOSTICS 
Invalid stream pointers will usually cause grave disorder, 
possibly including program termination. Individual 
function descriptions describe the possible error 
conditions. 


STDIPC(3C) 


NAME 
ftok — standard interprocess communication package 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipe.h> 


key_t ftok(path, id) 
char *path; 
char id; 


DESCRIPTION 

All interprocess communication facilities require the user 
to supply a key to be used by the magget(2), semget(2), 
and shmget(2) system calls to obtain interprocess 
communication identifiers. One suggested method for 
forming a key is to use the ftok subroutine described 
below. Another way to compose keys is to include the 
project ID in the most significant byte and to use the 
remaining portion as a sequence number. There are 
many other ways to form keys, but it is necessary for 
each system to define standards for forming them. If 
some standard is not adhered to, it will be possible for 
unrelated processes to unintentionally interfere with each 
other’s operation. Therefore, it is strongly suggested 
that the most significant byte of a key in some sense 
refer to a project so that keys do not conflict across a 
given system. 


Ftok returns a key based on path and td that is usable in 
subsequent msgget, semget, and shmget system calls. 
Path must be the path name of an existing file that is 
accessible to the process. Jd is a character which 
uniquely identifies a project. Note that ftok will return 
the same key for linked files when called with the same 
id and that it will return different keys when called with 
the same file name but different tds. 


SEE ALSO 
intro(2), msgget(2), semget(2), shmget(2). 
DIAGNOSTICS 


Ftok returns (key_t) —1 if path does not exist or if it is 
not accessible to the process. 


WARNING 
If the file whose path is passed to ftok is removed when 
keys still refer to the file, future calls to ftok with the 
same path and ¢d will return an error. If the same file is 
recreated, then ftok is likely to return a different key 
than it did the original time it was called. 


STRING (3C) 


NAME 
streat, strncat, stremp, strncmp, strcepy, strnepy, strlen, 
strehr, strrchr, strpbrk, strspn, strcspn, strtok — string 
operations 


SYNOPSIS 
#include <string.h> 


char *strcat (sl, s2) 
char *sl, *82; 

char *strncat (sl, s2, n) 
char *s1, *s2; 

int n; 


int stremp (sl, 82) 
char *sl, *s2; 

int strnemp (sl, s2, n) 
char *sl1, *s2; 

int n; 


char *strcepy (sl, s2) 
char *sl1, *s2; 

char *strncpy (sl, s2, n) 
char *sl, *s2; 

int n; 

int strlen (s) 

char *5; 

char *strchr (s, c) 

char *5; 

int c; 


char *strrchr (s, c) 
char *s; 
int ¢; 
char *strpbrk (s1, 82) 
char *sl, *s2; 
int strspn (sl, s2) 
char *sl1, *s2; 
int strespn (sl, 52) 
char *sl, *s2; 
char *strtok (sl, s2) 
char *sl, *82; 
DESCRIPTION 
The arguments sf, s2 and s point to strings (arrays of 
characters terminated by a null character). The 
functions strcat, strncat, strepy and strnepy all alter si. 


These functions do not check for overflow of the array 
pointed to by a1. 


NOTE 


STRING (3C) 


Streat appends a copy of string 82 to the end of string 
81. Strncat appends at most n characters. Each returns 
a pointer to the null-terminated result. 


Stremp compares its arguments and returns an integer 
less than, equal to, or greater than 0, according as s1 is 
lexicographically less than, equal to, or greater than 82. 
Strnemp makes the same comparison but looks at at 
most n characters. 


Strepy copies string s2 to si, stopping after the null 
character has been copied. Strnepy copies exactly n 
characters, truncating 82 or adding null characters to 31 
if necessary. The result will not be null-terminated if 
the length of 82 is n or more. Each function returns 31. 


Strlen returns the number of characters in s, not 
including the terminating null character. 


Strchr (strrchr) returns a pointer to the first (last) 
occurrence of character ¢ in string 8, or a NULL pointer 
if ¢ does not occur in the string. The null character 
terminating a string is considered to be part of the 
string. 


Strpbrk returns a pointer to the first occurrence in string 
si of any character from string 82, or a NULL pointer if 
no character from 82 exists in 81. 


Strspn (strespn) returns the length of the initial segment 
of string sf which consists entirely of characters from 
(not from) string 82. 


Strtok considers the string si to consist of a sequence of 
zero or more text tokens separated by spans of one or 
more characters from the separator string 82. The first 
call (with pointer s1 specified) returns a pointer to the 
first character of the first token, and will have written a 
null character into sf immediately following the 
returned token. The function keeps track of its position 
in the string between separate calls, so that subsequent 
calls (which must be made with the first argument a 
NULL pointer} will work through the string s1 
immediately following that token. In this way 
subsequent calls will work through the string si until no 
tokens remain. The separator string 82 may be different 
from call to call. When no token remains in sf, a NULL 
pointer is returned. 


For user convenience, all these functions are declared in 
the optional <string.h> header file. 


BUGS 


STRING (3C) 


Stremp and strnemp use native character comparison, 
which is signed on Convergent Technologies 68000- 
family processors. This means that characters are 8-bit 
signed values; all ASCII characters have values of at 
least 0; non-ASCII are negative. On some machines, all 
characters are positive. Thus programs that only 
compare ASCII values are portable; programs that 
compare ASCII with non-ASCII values are not. 


Character movement is performed differently in different 
implementations. Thus, overlapping moves may yield 
surprises, 


STRTOD(3C) 


NAME 
strtod, atof — convert string to double-precision number 


SYNOPSIS 
double strtod (str, ptr) 
char *str, **ptr; 
double atof (str) 
char *str; 


DESCRIPTION 
Strtod returns as a _ double-precision floating-point 
number the value represented by the character string 
pointed to by str. The string is scanned up to the first 
unrecognized character. 


Strtod recognizes an optional string of ‘‘white-space”’ 
characters (as defined by tsspace in ctype(3C)), then an 
optional sign, then a string of digits optionally 
containing a decimal point, then an optional e or E 
followed by an optional sign or space, followed by an 
integer. 


If the value of ptr is not (char **)NULL, a pointer to the 
character terminating the scan is returned in the location 
pointed to by ptr. If no number can be formed, *ptr is 
set to str, and zero is returned. 


Atof(str) is equivalent to strtod(str, (char **)NULL). 
SEE ALSO 
etype(3C), scanf(3S), strtol(3C). 
DIAGNOSTICS 
If the correct value would cause overflow, +HUGE is 
returned (according to the sign of the value), and errno 
is set to ERANGE. 


If the correct value would cause underflow, zero is 
returned and errno is set to ERANGE. 


NAME 


STRTOL(3C) 


strtol, atol, atoi — convert string to integer 


es SYNOPSIS 


long strtol (str, ptr, base) 
char *str, **ptr; 

int base; 

long atol (str) 

char *str; 


int atoi (str) 
char *str; 


DESCRIPTION 


Strtol returns as a long integer the value represented by 
the character string pointed to by str. The string is 
scanned up to the first character inconsistent with the 
base. Leading ‘‘white-space’’ characters (as defined by 
isspace in ctype(3C)) are ignored. 


If the value of ptr is not (char **)NULL, a pointer to the 
character terminating the scan is returned in the location 
pointed to by pér. If no integer can be formed, that 
location is set to str, and zero is returned. 


If base is positive (and not greater than 36), it is used as 
the base for conversion. After an optional leading sign, 
leading zeros are ignored, and ‘“‘Ox” or ‘‘OX” is ignored if 
base is 16. 

If base is zero, the string itself determines the base 
thusly: After an optional] leading sign a leading zero 
indicates octal conversion, and a leading “‘Ox”’ or ‘‘OX”’ 
hexadecimal conversion. Otherwise, decimal conversion 
is used. 

Truncation from long to int can, of course, take place 
upon assignment or by an explicit cast. 


Atol(str) is equivalent to strtol/str, (char **)NULL, 10). 
Atoi(str) is equivalent to (int) strtol(str, (char **)NULL, 
10). 


SEE ALSO 


BUGS 


ctype(3C), scanf(3S), strtod(3C). 


Overflow conditions are ignored. 
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NAME 
swab — swap bytes 


SYNOPSIS 
void swab (from, to, nbytes) 
char *from, *to; 
int nbytes; 


DESCRIPTION 
Swab copies nbytes bytes pointed to by from to the 
array pointed to by to, exchanging adjacent even and 
odd bytes. It is useful for carrying binary data between 
PDP-11ls and other machines. Nbytes should be even and 
non-negative. If nbytes is odd and positive swab uses 
nbytes—1 instead. If nbytes is negative, swab does 
nothing. 


SYSTEM (3S ) 


NAME 
system — issue a shell command 


SYNOPSIS 
#include <stdio.h> 


int system (string) 
char *string; 


DESCRIPTION 
System causes the string to be given to sh(1) as input, 
as if the string had been typed as a command at a 
terminal. The current process waits until the shel] has 
completed, then returns the exit status of the shell. 


FILES 
/bin/sh 
SEE ALSO 
sh(1), exec(2). 
DIAGNOSTICS 
System forks to create a child process that in turn exec’s 


/bin/sh in order to execute string. If the fork or exec 
fails, system returns a negative value and sets errno. 


NAME 


TERMCAP (3X) 


tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs —- 
terminal independent operations 


SYNOPSIS 


char PC; 
char *BC; 
char *UP; 
short ospeed; 


tgetent(bp, name) 
char *bp, *name; 
tgetnum(id) 

char *id; 
tgetflag(id) 

char *id; 


char * 
tgetstr(id, area) 
char *id, **area; 


char * 
tgoto(cmstr, destcol, destline) 
char *cmstr; 


tputs(cp, affent, outc) 
register char *cp; 

int affcnt; 

int (*outc)(); 


DESCRIPTION 


These functions extract and use information from 
terminal descriptions that follow the conventions in 
termcap(4). The functions only do basic screen 
manipulation: they find and output specified terminal 
function strings and interpret the cm string. Curses(3X) 
describes a screen updating package built on termcap. 


Tgetent finds and copies a terminal description. Name is 
the name of the description; bp points to a buffer to hold 
the description. Tgetent passes bp to the other termcap 
functions; the buffer must remain allocated until the 
program is done with the termcap functions. 


Tgetent uses the TERM and TERMCAP environment 
variables to locate the terminal description. 


° If TERMCAP isn’t set or is empty, tgetent 
searches for name in /ete/termceap. 
e If TERMCAP contains the full pathname of a 


file uy string that begins with /), tgetent 
searches for name in that file. 
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° If TERMCAP contains any string that does 
not begin with / and TERM is not set or 
matches name, tgetent copies the TERMCAP 


string. 

° If TERMCAP contains any string that does 
not begin with / and TERM does not match 
name,  tgetent searches for name in 
/etce/termcap. 


Tgetent returns —1 if it couldn’t open the terminal 
capability file, 0 if it couldn’t find an entry for name, 
and 1 upon success. 


Tgetnum returns the value of the numeric capability 
whose name is td. It returns —1 if the terminal lacks the 
specified capability or it is not a numeric capability. 


Tgetflag returns 1 if the terminal has boolean capability 
whose name is 7d, 0 if it does not or it is not a boolean 
capability. 


Tgetstr copies and interprets the value of the string 
capability named by td. Tgetstr expands instances in 
the string of \ and *. It leaves the expanded string in 
the buffer indirectly pointed to by e@rea and leaves the 
buffer’s direct pointer pointing to the end of the 
expanded string; for example, 


tgetstr("cl”, &ptr); 


where ptr is a character pointer -- not an array name! 
Tgetstr returns a (direct) pointer to the beginning of the 
string. 


Tgoto interprets the % escapes in a em string. It 
returns cmstr with the % sequences changed to the 
position indicated by destcol and destline. This function 
must have the external variables BC and UP set to the 
values of the be and up capabilities; if the terminal 
lacks the capability, set the external variable to null. If 
tgoto can’t interpret all the % sequences in ecm, it 
returns “OOPS” 


Tgoto avoids producing characters that might be 
misinterpreted by the terminal interface. If expanding a 
% sequence would produce a null, control-d, or null, the 
function will, if possible, send the cursor to the next line 
or column and use BC or UP to move to the correct 
location. Note that tgoto does not avoid producing tabs; 
a program must turn off the TAB3 feature of the 
terminal interface (termto(7)). This is a good idea 
anyway: some terminals use the tab character as a 
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nondestructive space. 


Tputs directs the output of a string returned by tgetstr 
or tgoto. This function must have the external variable 
PC set to the value of the pe capability; if the terminal 
lacks the capability, set the external variable to null. 
Tputs interprets any delay at the beginning of the string. 
Cp is the string to be output; affent is the number of 
lines affected by the action (1 if “number of lines 
affected’? doesn’t mean anything); and oute points to a 
function that takes a single char argument and outputs 
it, such as putchar. 


FILES 
/usr/lib/libtermcap.a library 
/etc/termcap data base 
SEE ALSO 


ex(1), curses(3), termcap(5) 


TMPFILE (3S ) 


NAME 
tmpfile — create a temporary file 

SYNOPSIS 
#include <stdio.h> 
FILE *tmpfile () 

DESCRIPTION 
Tmpfile creates a temporary file using a name generated 
by MED ET (SY) and returns a corresponding FILE 
pointer. If the file cannot be opened, an error message is 
printed using perror(3C), and a NULL pointer is 
returned. The file will automatically be deleted when 
the process using it terminates. The file is opened for 
update ("w+"). 

SEE ALSO 


creat(2), unlink(2), fopen(3S), mktemp(3C), perror(3C), 
tmpnam(3S). 


NAME 


TMPNAM (3S ) 


tmpnam, tempnam - create a name for a temporary file 


SYNOPSIS 


#include <stdio.h> 
char *tmpnam (s) 

char *s; 

char *tempnam (dir, pfx) 
char *dir, *pfx; 


DESCRIPTION 


These functions generate file names that can safely be 
used for a temporary file. 


Tmpnam always generates a file name using the path- 
prefix defined as P_tmpdir in the <stdio.h> header 
file. If s is NULL, tmpnam leaves its result in an internal 
static area and returns a pointer to that area. The next 
call to tmpnam will destroy the contents of the area. If 
8 is not NULL, it is assumed to be the address of an 
array of at least L_tmpnam bytes, where L_tmpnam 
is a constant defined in <stdto.k>; tmpnam places its 
result in that array and returns s. 


Tempnam allows the user to control the choice of a 
directory. The argument dtr points to the name of the 
directory in which the file is to be created. If dir is 
NULL or points to a string which is not a name for an 
appropriate directory, the path-prefix defined as 
P_tmpdir in the <stdio.h> header file is used. If that 
directory is not accessible, /tmp will be used as a last 
resort. This entire sequence can be up-staged by 
providing an environment variable TMPDIR in the 
user’s environment, whose value is the name of the 
desired temporary-file directory. 


Many applications prefer their temporary files to have 
certain favorite initial letter sequences in their names. 
Use the pfr argument for this. This argument may be 
NULL or point to a string of up to five characters to be 
used as the first few characters of the temporary-file 
name. 


Tempnam uses malloc(3C) to get space for the 
constructed file name, and returns a pointer to this area. 
Thus, any pointer value returned from tempnam may 
serve aS an argument to free (see malloc(3C)). If 
tempnam cannot return the expected result for any 
reason, i.e. matloets) failed, or none of the above 
mentioned attempts to find an appropriate directory was 
successful, a NULL pointer will be returned. 


NOTES 
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These functions generate a different file name each time 
they are called. 


Files created using these functions and either fopen(3S) 
or creat(2) are temporary only in the sense that they 
reside in a directory intended for temporary use, and 
their names are unique. It is the user’s responsibility to 
use unlink (2) to remove the file when its use is ended. 


SEE ALSO 


BUGS 


meer) unlink(2), fopen(3S), malloc(3C), mktemp(3C), 
tmpfile(3S). 


If called more than 17,576 times in a single process, these 
functions will start recycling previously used names. 
Between the time a file name is created and the file is 
opened, it is possible for some other process to create a 
file with the same name. This can never happen if that 
other process is using these functions or mktemp, and the 
file names are chosen so as to render duplication by 
other means unlikely. 


TRIG(3M) 


NAME 
sin, cos, tan, asin, acos, atan, atan2 —- trigonometric 
functions 

SYNOPSIS 


#include <math.h> 
double sin (x) 


double x; 
double cos (x) 
double x; 
double tan (x) 
double x; 
double asin (x) 
double x; 
double acos (x) 
double x; 
double atan (x) 
double x; 


double atan2 (y, x) 
double y, x; 


DESCRIPTION 
Sin, cos and tan return respectively the sine, cosine and 
tangent of their argument, z, measured in radians. 


Asin returns the arcsine of z, in the range — 7/2 to 7/2. 
Acos returns the arccosine of z, in the range 0 to 7. 


Atan returns the arctangent of z, in the range —7/2 to 
m/2. 

Atan2 returns the arctangent of y/z, in the range —7 to 
m, using the signs of both arguments to determine the 
quadrant of the return value. 


DIAGNOSTICS 

Sin, cos, and tan lose accuracy when their argument is 
far from zero. For arguments sufficiently large, these 
functions return zero when there would otherwise be a 
complete loss of significance. In this case a message 
indicating TLOSS error is printed on the standard error 
output. For less extreme arguments causing partial loss 
of significance, a PLOSS error is generated but no 
message is printed. In both cases, errno is set to 
ERANGE. 


If the magnitude of the argument of asin or acos is 
greater than one, or if both arguments of atan2 are zero, 
zero is returned and errno is set to EDOM. In addition, 
a message indicating DOMAIN error is printed on the 
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standard error output. 


These error-handling procedures may be changed with 
the function matherr(3M). 


SEE ALSO 
matherr(3M). 


TSEARCH(3C ) 


NAME 
tsearch, tfind, tdelete, twalk - manage binary search 
trees 


SYNOPSIS 
#include <search.h> 


char *tsearch ((char *) key, (char **) rootp, 
compar) 
int (*compar)( ); 


char *tfind ((char *) key, (char **) rootp, 
compar 
int (*compar)( ); 


char *tdelete ((char *) key, (char **) rootp, 
compar) 
int (*compar)( ); 


void twalk ((char *) root, action) 
void (*action)( ); 


DESCRIPTION 

Tsearch, tfind, tdelete, and twalk are routines for 
manipulating binary search trees. They are generalized 
from Knuth (6.2.2) Algorithms T and D. All 
comparisons are done with a user-supplied routine. This 
routine is called with two arguments, the pointers to the 
elements being compared. It returns an integer less 
than, equal to, or greater than 0, according to whether 
the first argument is to be considered less than, equal to 
or greater than the second argument. The comparison 
function need not compare every byte, so arbitrary data 
may be contained in the elements in addition to the 
values being compared. 


Tsearch is used to build and access the tree. Key is a 
pointer to a datum to be accessed or stored. If there is a 
datum in the tree equal to *key (the value pointed to by 
key), a pointer to this found datum is returned. 
Otherwise, *key is inserted, and a pointer to it returned. 
Only pointers are copied, so the calling routine must 
store the data. Rootp points to a variable that points 
to the root of the tree. A NULL value for the variable 
pointed to by rootp denotes an empty tree; in this case, 
the variable will be set to point to the datum which will 
be at the root of the new tree. 


Like tsearch, tfind will search for a datum in the tree, 
returning a pointer to it if found. However, if it is not 
found, tfind will return a NULL pointer. The arguments 
for tfind are the same as for tsearch. 
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Tdelete deletes a node from a binary search tree. The 
arguments are the same as for tsearch. The variable 
pointed to by rootp will be changed if the deleted node 
was the root of the tree. Tdelete returns a pointer to the 
parent of the deleted node, or a NULL pointer if the node 
is not found. 


Twalk traverses a binary search tree. Root is the root 
of the tree to be traversed. (Any node in a tree may be 
used as the root for a walk below that node.) Action is 
the name of a routine to be invoked at each node. This 
routine is, in turn, called with three arguments. The 
first argument is the address of the node being visited. 
The second argument is a value from an enumeration 
data type typedef enum { preorder, postorder, endorder, 
leaf } VISIT; (defined in the <search.h> header file), 
depending on whether this is the first, second or third 
time that the node has been visited (during a depth-first, 
left-to-right traversal of the tree), or whether the node is 
a leaf. The third argument is the level of the node in 
the tree, with the root being level zero. 


The pointers to the key and the root of the tree should 
be of type pointer-to-element, and cast to type pointer- 
to-character. Similarly, although declared as type 
pointer-to-character, the value returned should be cast 
into type pointer-to-element. 


EXAMPLE 
The following code reads in strings and stores structures 
containing a pointer to each string and a count of its 
length. It then walks the tree, printing out the stored 
strings and their lengths in alphabetical order. 


#include <search.h> 
#include <stdio.h> 


struct node { 
/* pointers to these are stored in the tree */ 
char *string; 


int length; 
} 
char string_space|10000}; /* space to store strings */ 
struct node nodes[500]; /* nodes to store */ 


struct node *root = NULL; 
/* this points to the root */ 


main( ) 

{ 
char *strptr = string_space; 
struct node *nodeptr = nodes; 
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void print_node( ), twalk( ); 
int i = 0, node_compare( ); 


while (gets(strptr) !== NULL && i++ < 500) { 
/* set node */ 
nodeptr— >string = strptr; 
nodeptr- >length = strlen(strptr); 
/* put node into the tree */ 
(void) tsearch((char *)nodeptr, &root, 
node_compare); 

/* adjust pointers, 

so we don’t overwrite tree */ 
strptr += nodeptr->length + 1; 
nodeptr++; 


twalk(root, print_node); 


} 

/* 
This routine compares two nodes, based on an 
alphabetical ordering of the string field. 

+} 

int 

node_compare(nodel, node2) 

struct node *nodel, *node2; 


t return stremp(nodel->string, node2- >string); 
} 
/* 
This routine prints out a node, the first time 
twalk encounters it. 
*/ 
void 


print_node(node, order, level) 
struct node *#node; 
VISIT order; 
int level; 
{ 
if (order == preorder || order == leaf) 
(void)printf("string = %20s, length = %d\n”, 
(*node)- >string, (*node)- >length); 


} 
SEE ALSO 
bsearch(3C), hsearch(3C), lsearch(3C). 


DIAGNOSTICS 
A NULL pointer is returned by tsearch if there is not 
enough space available to create a new node. 
A NULL pointer is returned by tsearch, tfind and tdelete 
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if rootp is NULL on entry. 

If the datum is found, both tsearch and tfind return a 
pointer to it. If not, tfind returns NULL, and tsearch 
returns a pointer to the inserted item. 


WARNINGS 


BUGS 


The root argument to twalk is one level of indirection 
less than the rootp arguments to tsearch and tdelete. 
There are two nomenclatures used to refer to the order 
in which tree nodes are visited. Tsearch uses preorder, 
postorder and endorder to respectively refer to visting a 
node before any of its children, after its left child and 
before its right, and after both its children. The 
alternate nomenclature uses preorder, inorder and 
postorder to refer to the same visits, which could result 
in some confusion over the meaning of postorder. 


If the calling function alters the pointer to the root, 
results are unpredictable. 


NAME 
ttyname, isatty — find name of a terminal 


TTYNAME(3C) 


SYNOPSIS 


char *ttyname (fildes) 


int fildes; 


int isatty (fildes) 
int fildes; 


DESCRIPTION 


Ttyname returns a pointer to a string containing the 
null-terminated path name of the terminal device 
associated with file descriptor fildes. 


Isatty returns 1 if ftldes is associated with a terminal 
device, 0 otherwise. 


FILES 
/dev/* 

DIAGNOSTICS 
Ttyname returns a NULL pointer if fildes does not 
describe a terminal device in directory /dev. 

BUGS 


The return value points to static data whose content is 
overwritten by each call. 


TTYSLOT(3C) 


NAME 
ttyslot — find the slot in the utmp file of the current 
user 

SYNOPSIS 
int ttyslot ( ) 

DESCRIPTION 
Ttyslot returns the index of the current user’s entry in 
the /etc/utmp file. This is accomplished by actually 
scanning the file /etc/inittab for the name of the 
terminal associated with the standard input, the 
standard output, or the error output (0, 1 or 2). 

FILES 
/etc/inittab 
/etc/utmp 

SEE ALSO 
getut(3C), ttyname(3C). 

DIAGNOSTICS 


A value of 0 is returned if an error was encountered 
while searching for the terminal name or if none of the 
above file descriptors is associated with a terminal 
device. 


UNGETC(3S) 


NAME 
ungetc — push character back into input stream 


SYNOPSIS 
#include <stdio.h> 


int ungetc (c, stream) 
int ¢; 
FILE *stream; 


DESCRIPTION 
Ungete inserts the character ¢ into the buffer associated 
with an input stream. That character, c, will be 
returned by the next getc($S) call on that stream. 
Ungete returns c, and leaves the file stream unchanged. 


One character of pushback is guaranteed, provided 
something has already been read from the stream and 
the stream is actually buffered. In the case that stream 
is stdin, one character may be pushed back onto the 
buffer without a previous read statement. 


If c equals EOF, ungetc does nothing to the buffer and 
returns EOF. 


Fseek(3S) erases all memory of inserted characters. 


SEE ALSO 
fseek(3S), getc(3S), setbuf(3S). 


DIAGNOSTICS 
Ungetc returns EOF if it cannot insert the character. 


VPRINTF (3S) 


NAME 
vprintf, vfprintf, vsprintf - print formatted output of a 
varargs argument list 


SYNOPSIS 
#include <stdio.h> 
#include <varargs.h> 


int vprintf (format, ap) 
char *format; 
va_list ap; 


int vfprintf (stream, format, ap) 
FILE *stream; 

char *format; 

va_list ap; 


int vsprintf (s, format, ap) 
char *s, *format; 
va_list ap; 

DESCRIPTION 
vprintf, ufprintf, and vsprintf are the same as printf, 
fprintf, and sprintf respectively, except that instead of 
being called with a variable number of arguments, they 
are called with an argument list as defined by 
varargs(5). 

EXAMPLE 
The following demonstrates how ufprintf could be used to 
write an error routine. 


#include <stdio.h> 
#include <varargs.h> 


/* 

* error should be called like 

* error(function_name, format, argl, arg2...); 
+ 

/*VARARGSO+/ 

void 


error(va_alist) 
/* Note that the function_name and format arguments 
* cannot be separately declared because of the 
* definition of varargs. 
*/ 
va_del 
{ 
va_list args; 
char *fmt; 
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va_start(args); 

/* print out name of function causing error */ 
(void}fprintf(stderr, "ERROR in %s: ”, va_arg(args, char *)); 
fmt = va_arg(args, char *); 

/* print out remainder of message */ 
(void)vfprintf(stderr, fmt, args); 
va_end(args); 

(void)abort( ); 


t 


SEE ALSO 
printf(3S), varargs(5). 
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NAME 


INTRO (4) 


intro — introduction to file formats 


DESCRIPTION 


This section outlines the formats of various files. The C 
struct declarations for the file formats are given where 
applicable. Usually, these structures can be found in the 
directories /usr/include or /usr/include/sys. 


Entries suffixed by y(n) describe the configuration files 
used with the CTIX networking packages. These files 
can be manipulated directly (using a text editor) or with 
netman(1NM). 


SEE ALSO 


Internet Protocol Transttton Workbook. Menlo Park, CA: 
Network Information Center, SRI International, 1982. 


CTIX Internetworking Manual. 


NAME 


A.OUT(4) 


a.out — common assembler and link editor output 


SYNOPSIS 


#include <a.out.h> 


DESCRIPTION 


The file name a.out is the output file from the 
assembler as(1) and the link editor /d(1). Both programs 
will make a.out executable if there were no errors in 
assembling or linking and no unresolved external 
references. 


A common object file consists of a file header, a CTIX 
system header, a table of section headers, relocation 
information, (optional) line numbers, a symbol table, and 
a string table. The order is given below. 


File header. 
CTIX system header. 
Section 1 header. 


Section n header. 
Section 1 data. 


Section n data. 
Section 1 relocation. 


Section n relocation. 
Section 1 line numbers. 


Section n line numbers. 
Symbol table. 
String table. 


The last three parts (line numbers, symbol table and 
string table) may be missing if the program was linked 
with the —s option of /d(1) or if they were removed by 
strip(1). Also note that the relocation information will 
be absent if there were no unresolved external references 
after linking. The string table exists only if the symbol 
table contains symbols with names longer than eight 
characters. 


The sizes of each section (contained in the header, 
discussed below) are in bytes and are even. 


When an a.out file is loaded into memory for execution, 
three logical segments are set up: the text segment, the 
data segment (initialized data followed by uninitialized, 
the latter actually being initialized to all 0’s), and a 
stack. The text segment begins at location 0x0000 in the 
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core image. The header is never loaded, except for 
magic 0413 files created with the —F option of /d(1). If 
the magic number (the first field in the operating system 
header) is 407 (octal), it indicates that the text segment 
is not to be write-protected or shared, so the data 
segment will be contiguous with the text segment. If the 
magic number is 410 (octal), the data segment and the 
text segment are not writable by the program; if other 
processes are executing the same a.out file, the processes 
will share a single text segment. Magic number 413 
(octal) is the same as 410 (octal), except that 413 (octal) 
permits demand paging. Both the —z and —F options of 
the loader /d(1) create a.out files with magic numbers 
0413. If the —z option is used, both the text and data 
sections of the file are on 1024-byte boundaries. If the 
—F option is used, the text and data sections of the file 
are contiguous. Loading a single 4096-byte page into 
memory requires 4 transfers of 1024 bytes each for —z, 
and typically one transfer of 4096 bytes for —F. Thus 
a.out files created with —F can load faster and require 
less disk space. 


The stack begins at the end of memory and grows 
towards lower addresses. The stack is automatically 
extended as required. The data segment is extended 
only as requested by the brk(2) system call. 


The value of a word in the text or data portions that is 
not a reference to an undefined external symbol is 
exactly the value that will appear in memory when the 
file is executed. If a word in the text involves a reference 
to an undefined external symbol, the storage class of the 
symbol-table entry for that word will be marked as an 
“external symbol”, and the section number will be set to 
0. When the file is processed by the link editor and the 
external symbol becomes defined, the value of the 
symbol will be added to the word in the file. 


File Header 
The format of the filehdr header is 
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struct filehdr 


{ 
unsigned short f_magic; /* magic number */ 
unsigned short f_nscns; /* number of sections */ 
long f_timdat; /* time and date stamp */ 
long f_symptr; /* file ptr to symtab */ 
long f_nsy ms; /* # symtab entries */ 
unsigned short f_opthdr; /* sizeof(opt hdr) */ 
unsigned short f_flags; /* flags */ 

hi 


CTIX System Header 
The format of the CTIX system header is 


typedef struct aouthdr 


{ 
short magic; /* magic number */ 
short vstamp; /# version stamp */ 
long _ tsize; /* text size in bytes, padded +/ 
long dsize; /* initialized data (.data) */ 
long _ bsize; /* uninitialized data (.bss) */ 
long entry; /* entry point */ 


long text_start; /* base of text used for this file */ 
long data_start; /* base of data used for this file */ 
} AOUTHDR; 


Section Header 
The format of the section header is 


struct senhdr 


{ 
char s_name|SYMNMLEN];/* section name */ 
long s_paddr; /* physical address */ 
long s_vaddr; /* virtual address */ 
long 8_size; /* section size */ 
long s_senptr; /* file ptr to raw data */ 
long s_relptr; /* file ptr to relocation */ 
long s_Innoptr; /* file ptr to line numbers */ 
unsigned short s_nreloc; /* # reloc entries */ 
unsigned short s_ninno; /* # line number entries */ 
long s_flags; /* flags */ 

} 
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Relocation 
Object files have one relocation entry for each 
relocatable reference in the text or data. If relocation 
information is present, it will be in the following format: 


struct reloc 


{ 
long _—r_vaddr;/* (virtual) address of reference */ 
long = r_symndx; /* index into symbol table */ 
short r_type; /* relocation type */ 

}; 


The start of the relocation information is s_relptr from 
the section header. If there is no relocation information, 
s_relptr is 0. 

Symbol Table 
The format of each symbol in the the symbol table is 


#define SYMNMLEN 8 
#define FILNMLEN 14 


#define SYMESZ 18 /* the size of a SYMENT */ 
struct syment 
{ 
union /* get a symbol name */ 
{ 
char —n_name{[SYMNMLEN]; /# name of symbol #/ 
struct 
{ 
long _N_zeroes; /* == OL if in string table */ 
long _n_offset; /* location in string table */ 
} _n_n; 
char *_n_nptr(2|;_ /* allows overlaying */ 
} an 
unsigned long n_value; /* value of symbol */ 
short n_scnum; /* section number */ 
unsigned short n_type; /* type and derived type */ 
char n_sclass; /* storage class +/ 
char n_numaux; /* number of aux entries */ 
i 
#define n_name _n._n_name 
#define n_zeroes _n._n_n._n_zeroes 
#define n_offset _n._n_n._n_offset 


#define n_nptr n._n_nptr(1| 


Some symbols require more information than a single 
entry; they are followed by auziliary entries that are the 
same size as a symbol entry. The format follows. 
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union auxent { 


struct { 
long x_tagndx; 
union { 
struct { 
unsigned short x_inno; 
unsigned short x_size; 
} x_Insz; 
long x_fsize; 
} x misc; 
union { 
struct { 
long x_Innoptr; 
long x_endndx; 
} xtfen; 
struct { 
unsigned short x_dimen|DIMNUM]; 
} xary; 
} x_fenary; 
unsigned short x_tvndx; 
} x_sym; 
struct { 
char x_fname(FILNMLEN]; 
} x_file; 
struct { 
long x_scnien; 


unsigned short x_nreloc; 
unsigned short x_nlinno; 
} x_sen; 


struct { 
long x_tvfill; 
unsigned short x_tvlen; 
unsigned short x_tvran|[2]; 
} x_ty; 
} 
Indexes of symbol table entries begin at zero. The start 
of the symbol table is f_symptr (from the file header) 
bytes from the beginning of the file. If the symbol table 
is stripped, f_symptr is 0. The string table (if one exists) 
begins at f_symptr + (f.nsyms * SYMESZ) bytes from 
the beginning of the file. 


Bye al e(1), 1d(1), brk(2), filehdr(4), Idfen(4), 1 (4) 
as(1)}, c , br ehdr en(4), linenum(4), 
reloc(4), senhdr(4), syms(4). 
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NAME 

acct — per-process accounting file format 
SYNOPSIS 

#include <sys/acct.h> 
DESCRIPTION 


Files produced as a result of calling acct(2) have records 


in the form defined by <sys/acct.h>, whose contents 
are: 


typedef ushort comp_t; /* “floating point” */ 
/* 13-bit fraction, 3-bit exponent */ 


struct acct 


{ 
char ac_flag; /* Accounting flag */ 
char ac_stat; /* Exit status */ 
ushort ac_uid; /* Accounting user ID */ 
ushort ac_gid; /* Accounting group ID */ 
dev_t ac tty; /* control typewriter */ 
time_t ac_btime; /* Beginning time */ 
comp_t ac_utime; /* acctng user time in clock ticks */ 
comp_t ac_stime; /* acctng system time in clock ticks */ 
comp_t ac_etime; /* acctng elapsed time in clock ticks */ 
comp_t ac_mem; /* memory usage in clicks */ 
comp_t ac_io; /* chars trnsfrd by read/write */ 
comp_t ac _rw; /* number of block reads/writes */ 
char ac_comm|8]; /* command name */ 

}; 


extern struct acct acctbuf; 
extern struct inode *acctp; /* inode of accounting file */ 


#define AFORK 01 /* has executed fork, but no exec */ 
#define ASU 02 /* used super-user privileges */ 
#define ACCTF 0300 /* record type: 00 = acct */ 


In ec_flag, the AFORK flag is turned on by each fork(2) 
and turned off by an exec(2). The ac_comm field is 
inherited from the parent process and is reset by any 
exec. Each time the system charges the process with a 
clock tick, it also adds to ac_mem the current process 
size, computed as follows: 


(data size) + (text size) / (number of in-core 
processes using text) 


The value of ac_mem/ (ac_stime + ac_utime) can be 
viewed as an approximation to the the resident-set size 
(or mean process size), defined as the total number of 
pages in memory. Note that this differs from the UNIX 
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System V formula, which is based on the current process 
size; such a formula is inappropriate to a paging 
environment. 


The structure tacct.h, which resides with the source files 
of the accounting commands, represents the total 
accounting format used by the various accounting 
commands: 


/* 

* total accounting (for acct period), also for day 

*/ 

struct tacct { 
uid_t  ta_uid; /* userid */ 
char ta_name[8}; /* login name */ 
float  ta_cpu[2|; /* cum. cpu time, p/np (mins) */ 
float — ta_kcore[2|;_ /* cum kcore-minutes, p/np */ 
float  ta_con(2];/ /* cum. connect time, p/np, mins */ 
float ta_du; /* cum. disk usage */ 
long ta_pe; /* count of processes */ 
unsigned short ta_sc; /* count of login sessions */ 
unsigned short ta_de; /* count of disk samples +/ 
unsigned short ta_fee; /* fee for special services */ 

} 

SEE ALSO 


BUGS 


acct(1M), acctcom(1), acct(2), exec(2), fork(2). 


The ac_mem value for a short-lived command gives little 
information about the actual size of the command, 
because ac_mem may be incremented while a different 
command (e.g., the shell) is being executed by the 
process. 


-a-, 


NAME 


AR(4) 


ar — common archive file format 


DESCRIPTION 


The archive command ar(1) is used to combine several 
files into one. Archives are used mainly as libraries to be 
searched by the link editor /d(1). 


Each archive begins with the archive magic string. 


#define ARMAG "!<arch>\n" 
/* magic string */ 
#define SARMAG 8 
/* length of magic string */ 


Each archive which contains common object files (see 
a.out(4)) includes an archive symbol table. This symbol 
table is used by the link editor [d(1) to determine which 
archive members must be loaded during the link edit 
process. The archive symbol table (if it exists) is always 
the first file in the archive (but is never listed) and is 
automatically created and/or updated by ar. 


Following the archive magic string are the archive file 
members. Each file member is preceded by a file 
member header which is of the following format: 


#define ARFMAG ”‘\n” /* header trailer string */ 

struct ar_hdr /* file member header +/ 

{ 
char ar_name(16]; /*’/' terminated file member name */ 
char ar_date|12); /* file member date */ 
char ar_uid|6]; /* file member user identification */ 
char ar_gid|6]; /* file member group identification */ 
char ar_mode(8}; /* file member mode (octal) */ 
char ar_size[10]; /* file member size */ 
char ar_fmag(2]; /* header trailer string */ 

hi 


All information in the file member headers is in printable 
ASCII. The numeric information contained in the 
headers is stored as decimal numbers (except for 
ar_mode which is in octal). Thus, if the archive contains 
printable files, the archive itself is printable. 


The ar_name field is blank-padded and slash (/) 
terminated. The ar_date field is the modification date 
of the file at the time of its insertion into the archive. 
Common format archives can be moved from system to 
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system as long as the portable archive command ar(1) is 
used. Conversion tools such as arcv{1) and convert(1) 
exist to aid in the transportation of non-common format 
archives to this format. 


Each archive file member begins on an even byte 
boundary; a newline is inserted between files if 
necessary. Nevertheless the size given reflects the actual 
size of the file exclusive of padding. 


Notice there is no provision for empty areas in an 
archive file. 


If the archive symbol table exists, the first file in the 
archive has a zero length name (ie., ar_name(0} =— 
’/’). The contents of this file are as follows: 


° The number of symbols. Length: 4 bytes. 

° The array of offsets into the archive file. 
Length: 4 bytes * “the number of symbols’’. 

° The name string table. Length: ar_size — (4 


bytes * (“the number of symbols” + 1)). 


The number of symbols and the array of offsets are 
managed with sgetl and sputl. The string table contains 
exactly as many null terminated strings as there are 
elements in the offsets array. Each offset from the array 
is associated with the corresponding name from the 
string table (in order). The names in the string table are 
all the defined global symbols found in the common 
object files in the archive. Each offset is the location of 
the archive header for the associated symbol. 


SEE ALSO 


BUGS 


ar(1), arev(1), convert(1), Id(1), strip(1), sputl(3X), 
a.out(4). 


Strip(1) will remove all archive symbol entries from the 
header. The archive symbol entries must be restored via 
the ts option of the ar{1) command before the archive 
can be used with the link editor /d(1). 
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checklist — list of file systems processed by fsck 


DESCRIPTION 
Checklist resides in directory /ete and contains a list of 
at most 15 spectal file names. Each spectal file name is 
contained on a separate line and corresponds to a file 
system. Each file system will then be automatically 
processed by the fack(1M) command. 


SEE ALSO 
fsck(1M). 
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core — format of core image file 


DESCRIPTION 


CTIX writes out a core image of a terminated process 
when any of various errors occur. See signal(2) for the 
list of reasons; the most common are memory violations, 
illegal instructions, bus errors, and user-generated quit 
signals. The core image is called core and is written in 
the process’s working directory (provided it can be; 
normal access controls apply). A process with an 
effective user ID different from the real user ID will not 
produce a core image. 


The first section of the core image is a copy of the 
system’s per-user data for the process, including the 
registers as they were at the time of the fault. The size 
of this section depends on the parameter USIZE, which 
is defined in /usr/include/sys/page.h. The 
remainder represents the actual contents of the user’s 
core area when the core image was written. If the text 
segment is read-only and shared, or separated from data 
space, it is not dumped. 


The format of the information in the first section is 
described by the user structure of the system, defined in 
juss include jays /user ts The important stuff not 
detailed therein is the locations of the registers, which 
are outlined in /usr/include/sys/reg.h. 


SEE ALSO 


crash(1M), sdb(1), setuid(2), signal(2). 
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NAME 
cpio — format of cpio archive 


ets DESCRIPTION 
‘ The header structure, when the —e option of cpto(1) is 


not used, is: 
struct { 
short a magic, 
h_ eV; 
ushort h_ino, 
h_mode, 
h_uid, 
h_gid; 
short h_nlink, 
_Tdev, 
h_mtime|2j, 


h_namesize, 
h_filesize|2]; 
char h_name(h_namesize rounded to word]; 
} Har; 
When the —e option is used, the header information is 
described by: 


Co sscanf(Chdr, 
"%60%60%60%60%60%60%60% 60% | 110% 60% 1 1lo%s", 
&Hdr.h_magic, &Hdr.h_dev, &Hdr.h_ino, 
&Hdr.h_mode, &Hdr.h_uid, &Hdr.h_gid, 
&Hdr.h_nlink, &Hdr.h_rdev, &Longtime, 
&Hdr.h_namesize,&Longfile,Hdr.h_name); 


Longtime and Longfile are equivalent to Hdr.h_mtime 
and Hdr.h_filestze, respectively. The contents of each 
file are recorded in an element of the array of varying 
length structures, archive, together with other items 
describing the file. Every instance of h_magic contains 
the constant 070707 (octal). The items h_dev through 
h_mtime have meanings explained in stat(2). The length 
of the null-terminated path name h_name, including the 
null byte, is given by h_namesize. 
The last record of the archive always contains the name 
TRAILER!!!. Special files, directories, and the trailer are 
recorded with h_filestze equal to zero. 

SEE ALSO 
cpio(L), find(L), stat(2). 


NAME 


CPROFILE(4) 


cprofile — setting up a C shell environment at login time 


DESCRIPTION 


FILES 


eprofile is for use with csh(1). For every user of csh the 
system file /ete/cprofile is executed immediately upon 
login. If the user’s login directory contains a file named 
-cshre, that file will then be executed, followed by 
commands from the .login file. 


The following example is typical for a user’s .eshre file: 


setenv PATH :$PATH:$HOME/bin 
setenv MAIL /usr/mail/myname 
setenv TERM pt 

umask 022 


The system file /etc/cprofile can be customized to set 
the TERM environment variable via tset(1) and to 
automatically invoke wm(1) on RS-422 terminals. 


For further information about setting variables, see 
csh(1) and sh(1). 


$HOME/.login 
$HOME/.cshre 
$HOME/. logout 
/ete/cprofile 


SEE ALSO 


esh(1), cprofile(4), env(1), login(1), mail(1), sh(1), stty(1), 
suit) tset(1), wm(1), ttytype(4), environ(5), term(5). 
MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 


NAME 


DIR(4) 


dir — format of directories 


SYNOPSIS 


#include <sys/dir.h> 


DESCRIPTION 


A directory behaves exactly like an ordinary file, save 
that no user may write into a directory. The fact that a 
file is a directory is indicated by a bit in the flag word of 
its i-node entry (see fs(4)). The structure of a directory 
entry as given in the include file is: 


#ifndef DIRSIZ 
#define DIRSIZ14 
#endif 

struct — direct 


ino_t d_ino; 
char d_name(DIRSIZ]; 
, 
By convention, the first two entries in each directory are 
for. and... The first is an entry for the directory itself. 
The second is for the parent directory. The meaning of 
.. is modified for the root directory of the master file 


system; there is no parent, so... has the same meaning 
as .. 


SEE ALSO 


fs(4). 
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NAME 
errfile — error-log file format 


SYNOPSIS 
#include <sys/erec.h> 


DESCRIPTION 
When hardware errors are detected by the system, an 
error record is generated and passed to the error-logging 
daemon for recording in the error log for later analysis. 
The default error log is /usr/adm/errfile. 


The format of an error record depends on the type of 
error that was encountered. Every record, however, has 
a header with the following format: 
struct errhdr { 
short e_type; /* record type */ 
short e_len; _/* bytes in record (inc hdr) */ 
time_t e_time; /* time of day */ 


The permissible record types are as follows: 


#define ELGOTS 010 /* start */ 

#define ELSTOP 012 /* stop */ 

#define E.TCHG 013 /* time change */ 

#define ELCCHG 014 /* configuration change */ 
#define E_BLK 020 /* block device error */ 
#define ESTRAY 030 /* stray interrupt */ 
#define ELPRTY 031 /* memory parity */ 
#define ELBUSFLT 032 /* bus fault #/ 

#define ELCONS 040 /* console string */ 
#define ELCONR 041 /* console record */ 
#define ELCONO 042 /* console overflow */ 
#define E.SERIAL 043 /* serial device driver error */ 


Some records in the error file are of an administrative 
nature. These include the startup record that is entered 
into the file when logging is activated, the stop record 
that is written if the daemon is terminated “gracefully’’, 
and the time-change record that is used to account for 
changes in the system’s time-of-day. These records have 
the following formats: 
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struct estart { 


short e_cpu; /* CPU type #/ 

struct utsname e_name; /* system names */ 

short e_mmr3; /* boot reason from CDT #/ 

long e_syssize; /* system memory size */ 

int e_fhole; /* 64K chunks of memory omitted */ 
short e_bconf; /* block dev configuration #/ 

char e_panic; /* if reboot from panic, what was it */ 


} 
#define eend errhdr /* record header */ 


struct etimehg { 
time_t e_ntime; /* new time */ 
}: 


Stray interrupts cause a record with the following format 
to be logged: 


struct estray { 
physadr e_saddr; /* stray loc or device addr */ 
short e_sbacty; /* active block devices #/ 
}; 
Memory subsystem error causes the following record to 
be generated: 


For MiniFrame systems: 


struct eparity { 

ushort e_gsr; /* general status register */ 

ushort e_pte; /* pte for virtual address in BSR */ 
}s 
For MightyFrame systems: 


struct eparity { 
uint e_gsr; /* general status register */ 
}h 


Error records for block devices have the following 
format: 
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struct eblock { 
dev_t  e_dev; /* “true” major + minor dev no */ 
physadr e_regloc; /* controller address */ 
short e_bacty; /* other block I/O activity */ 
struct iostat { 
long io_ops; /* number read/writes */ 
long io_misc; /* number “other” operations */ 
ushortio_unlog; /* number unlogged errors */ 
} e_stats; 
short e_bflags; /* read/write, error, etc */ 
short e_trkoff; /* logical dev start trk */ 
daddr_t e_bnum; /* logical block number */ 
ushort e_bytes; /* number bytes to transfer #/ 
paddr_t e_memadd;/* buffer memory address */ 
ushort e_rtry; /* number retries */ 
short e_nreg; /* number device registers */ 
short e_trks /* number of heads */ 
short  e secs /* number of physical sectors per track */ 
short  e_ctlr /* controller type */ 
hi 
The following values are used in the e_bflags word: 


#define ELWRITE 0 /* write operation * 
#define EREAD 1 /* read operation * 
#define ELNOIO 02 /* no I/O pending */ 
#define ELPHYS 04 /* physical I/O */ 
#define E_LMAP 010 /* Unibus map in use */ 
#define ELERROR 020 /* I/O failed */ 


The error types CONS and CONO are flagged by 
errdemon(1M) and errdead and written to the console 


log /etc/log/confile. 
A bus fault generates the following record. 


struct ebusflt { 


short e_type; /* kind of fault */ 
caddr_t e_vaddr /* virtual address of fault */ 


uint e_bsr; /* combined bsr0 and bsr1 */ 
ushort e_pte; /* page frame of fault */ 
ushort e_pid; /* pid */ 

uint e_pe; /* PC at time of fault */ 
uint e_Ips; /* RPS at time of fault */ 


uint e_regs({16]; /* all the registers */ 
; 
A serial driver error generates the following reports: 


struct eserial { 
ushort e_type /* type of error */ 
ushort e_dev /* which physical port */ 
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}; 
The following types exist for e_type: 


#define ECHLOS Ox1 /* character lost in input FIFO */ 
#define ERXORUN 0x2 /* receiver overrun */ 

#define ENOCLIST 0x4 /* no new clist available */ 
#define ENORBUF 0x8 /* no receive buffer available */ 


SEE ALSO 
errdemon(1M). 
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AME 
filehdr — file header for common object files 
SYNOPSIS 
#include <filehdr.h> 
DESCRIPTION 


Every common object file begins with a 20-byte header. 
The following C struct declaration is used: 


struct filehdr 


unsigned short f_magic; /* magic number */ 
unsigned short f_nscns; /* number of sections */ 
long f_timdat; /* time & date stamp */ 
long f_symptr; /* file ptr to symtab */ 
long f_nsyms; /* # symtab entries */ 
unsigned short f_opthdr; —/* sizeof(opt hdr) */ 
unsigned short f_flags; /* flags P 


ba 
F_symptr is the byte offset into the file at which the 


symbol table can be found. Its value can be used as the 
offset in fseek(3S) to position an I/O stream to the 


symbol table. The operating system optional header is 
always 36 bytes. The valid magic numbers are given 
below. 


#define MC68KWRMAGIC — 0520 

/* writeable text segments */ 
#define MC68KROMAGIC 0521 

/* readonly shareable text segments */ 
#define MC68KPGMAGIC 0522 

/* demand paged text segments */ 


The value in f_timdat is obtained from the time(2) 
system call. 
Flag bits currently defined are: 
#define FLRELFLG 00001 
/* relocation entries stripped */ 


# define F_LEXEC 00002 
/* file is executable */ 
#define F_LNNO 00004 


/* line numbers stripped */ 
#define F_LSYMS 00010 

/* local symbols stripped */ 
# define F_MINMAL 00020 
/* minimal object file */ 
#define F_UPDATE 00040 

/* update file, ogen produced */ 
# define F_SWABD 00100 


ae 
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/* file is "pre-swabbed” */ 
#define F_AR32W 01000 

/* non-DEC host, 

including Convergent 

Technologies systems */ 
#define F_ PATCH 02000 

/* "patch” list in opt hdr */ 
The CPU type is encoded in bits 04000 and 010000. The 
FPU (floating-point unit) type is encoded in bits 
0100000, 040000, and 020000. Macros are defined to set 
and extract the CPU and FPU values as follows: 


SETCPU(flag, value 
GETFPU(flag 
GETCPU(flag 


Value values for CPU are: 


SETOPURee vata 


# define F_M68010 0 
#define F_M68020 1 


Valid values for FPU are: 


#define F_NOFPU 
#define F_SOFT 
# define F_M68381 
#define F_SKY 


CE No a) 


SEE ALSO 


time(2), fseek(3S), a.out(4). 
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NAME 
fs — file system format 


SYNOPSIS 
#include <sys/filsys.h> 
#include <sys/types.h> 
#include <sys/param.h> 
#include <sys/filbitmap.h> 


DESCRIPTION 
Every file system storage volume has a common format 
for certain vital information. Every such volume is 
divided into a certain number of 512-byte long sectors. 
Sector 0 is unused and is available to contain a bootstrap 
program or other information. 


Sector 1 is the super-block. The format of a super-block 


1s: 

/* 

* Structure of the super-block 

*/ 

struct filsys 

ushort  s_isize; /* size in blocks of i-list */ 
daddr_t s_fsize; /* size in blocks of entire volume */ 
short s_nfree; /* number of addresses in s_free */ 
daddr_t s_free{NICFREE|; /* free block list */ 
short s_ninode; /* number of i-nodes in s_inode */ 
ino_t  s_inode[NICINOD]; /* free i-node list */ 
char s_flock; /* lock during free list manipulation */ 
char s_ilock; /* lock during i-list manipulation */ 
char s_fmod; /* super block modified flag */ 
char s_ronly; /* mounted read-only flag */ 
time_t s_time; /* last super block update */ 
short  s_dinfo[4]; /* device information */ 
daddr_t s_tfree; /* total free blocks*/ 
ino_t s_tinode; /* total free i-nodes */ 
char s_fname[6]; _/* file system name */ 


char s_fpack|6]; —_/* file system pack name */ 

sema_t s_semflock; 

sema_t s_semilock; 

long s_file[1]; 

short —_s_fills; /* more adjust */ 

short s_bucnum;  /* Bucket currently in use */ 
daddr_t s_buckets|2]; /* addresses of buckets for bitmap */ 
daddr_t s_bitmap[2]; /* address of free bitmap */ 


char s_fsbitmap; /* if set, file system has 

a valid bitmap */ 
char s_fsok; /* if set then file system clean */ 
short —s_fill2(3]; /* used to be used by pilf */ 
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long S_magic; /* magic number to denote new 
file system */ 
long s_type; /* type of new file system */ 
long s_fill3[2|; /* final ADMUSTMENT so 
sizeof filsys is 512 */ 
} 
#define FsMAGIC Oxfd187e20 /* s_magic number */ 
#define Fslb 1 /* 512 byte block */ 
#define Fs2b 2 /* 1024 byte block */ 


CTIX recognizes two kinds of file systems, specified by 

s_type: 

° Oriented to 512-byte I/O. Identified by an 
s_type equal to Fslb. This type is also assumed 
if s_magic is not equal to FsMAGIC. (This 
type was originally the only type supported by 
UNIX Systems; CTIX does not support this type.) 


e Oriented to 1024-byte I/O. Identified by an 
s_type equal to Fs2b. This is essentially the 
standard file system for CTIX and UNIX System 
V. 


In the following description, the size of a logical block is 
determined by the file system type. For the original 
512-byte oriented file system, a block is 512 bytes. For 
the 1024-byte oriented file system a block is 1024 bytes 
or two sectors. The operating system takes care of all 
conversions from logical block numbers to physical sector 
numbers. 


S_istze is the address of the first data block after the i- 
list; the i-list starts just after the super-block, namely in 
block 2; thus the i-list is s_tstze—2 blocks long. S_/fsize 
is the first block not potentially available for allocation 
to a file. These numbers are used by the system to 
check for bad block numbers; if an ‘impossible’ block 
number is allocated from the free list or is freed, a 
diagnostic is written on the on-line console. Moreover, 
the free array is cleared, so as to prevent further 
allocation from a presumably corrupted free list. 


The free list for each volume is maintained as follows. 
The s_free array contains, in s_free(l], ..., 
s_free{s_nfree—1], up to 49 numbers of free blocks. 
S_free|0] is the block number of the head of a chain of 
blocks constituting the free list. The first long in each 
free-chain block is the number (up to 50) of free-block 
numbers listed in the next 50 longs of this chain 
member. The first of these 50 blocks is the link to the 
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next member of the chain. To allocate a_ block: 
decrement s_nfree, and the new block is s_free|s_nfree]. 
If the new block number is 0, no blocks remain, so give 
an error. If s_nfree became 0, read in the block named 
by the new block number, replace s_nfree by its first 
word, and copy the block numbers in the next 50 longs 
into the s_free array. To free a block, check if s_nfree 
is 50; if so, copy s_nfree and the s_free array into it, 
write it out, and set s_nfree to 0. In any event set 
s_free |s_ nfree| to the freed block’s number and 
increment s_nfree. 


S_tfree is the total free blocks available in the file 
system. 


S_ninode is the number of free i-numbers in the s_inode 
array. To allocate an i-node: if s_ninode is greater than 
0, decrement it and return s_tnode Es pina If it was 
0, read the i-list and place the numbers of all free i-nodes 
(up to 100) into the s_imode array, then try again. To 
ree an i-node, provided s_ninode is less than 100, place 
its number into s_inode|s_ninode| and_ increment 
s_ninode. If s_ninode is already 100, do not bother to 
enter the freed i-node into any table. This list of i-nodes 
is only to speed up the allocation process; the 
information as to whether the i-node is really free or not 
is maintained in the i-node itself. 


S_tinode is the total free i-nodes available in the file 
system. 


S_flock and s_ilock are flags maintained in the core copy 
of the file system while it is mounted and their values on 
disk are immaterial. The value of s_fmod on disk is 
likewise immaterial; it is used as a flag to indicate that 
the super-block has changed and should be copied to the 
disk during the next periodic update of file system 
information. 


S_ronly is a read-only flag to indicate write-protection. 


S_time is the last time the super-block of the file system 
was changed, and is the number of seconds that have 
elapsed since 00:00 Jan. 1, 1970 (GMT). During a reboot, 
the s_time of the super-block for the root file system is 
used to set the system’s idea of the time. 


S_fname is the name of the file system and s_fpack is 
the name of the pack. 


I-numbers begin at 1, and the storage for i-nodes begins 
in block 2. Also, i-nodes are 64 bytes long. I-node 1 is 
reserved for future use. I-node 2 is reserved for the root 
directory of the file system, but no other i-number has a 
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built-in meaning. Each i-node represents one file. For 
the format of an i-node and its flags, see tnode(4). 


The s_fsok flag indicates that the file system was 
unmounted after the last use, or that fsck was run 
successfully. The s_fsbttmap flag indicates that the file 
system has a valid bitmap describing a number of blocks 
that are omitted from the free list; these blocks are 
placed on the bitmap (filbitmap.h). If both flags are 
set, CTIX uses the bitmap; otherwise the old free list is 
used and any blocks that were in the bitmap (not on the 
free list) will be lost until fsck is run. 


s_buckets and s_bitmap are the disk addresses of the 
filbitmap structure; each address is for a 1024-byte logical 
block. 


All allocations of blocks are made from the bitmap. If a 
block being deallocated is in the section of the disk 
represented by s_bucknum, it is put in the bitmap. If 
the block is not in the area represented by the bitmap, it 
is put on the free list. 


The format of the file system bitmap and bucket list is: 


struct filbitmap{ 
/* list of buckets describing the free list */ 
ushort fb_buckets({1024]; 
(° bitmap describing free blocks no on the free list */ 
ong fb_bitmap[512}; 


, 


/usr/include/sys/filsys.h 
/usr/include/sys/stat.h 
/usr/include/sys/filbitmap.h 


SEE ALSO 


fsck(1M), fsdb(1M), mkfs(1M), inode(4). 


NAME 


FSPEC(4) 


fspec — format specification in text files 


DESCRIPTION 


It is sometimes convenient to maintain text files on CTIX 
with non-standard tabs, (i.e., tabs which are not set at 
every eighth column). Such files must generally be 
converted to a standard format, frequently by replacing 
all tabs with the appropriate number of spaces, before 
they can be processed by CTIX commands. A format 
specification occurring in the first line of a text file 
specifies how tabs are to be expanded in the remainder 
of the file. 


A format specification consists of a sequence of 
parameters separated by blanks and surrounded by the 
brackets <: and :>. Each parameter consists of a 
keyletter, possibly followed immediately by a value. The 
following parameters are recognized: 


ttabs The t parameter specifies the tab settings 
for the file. The value of tabs must be one 
of the following: 


1. a list of column numbers separated by 
commas, indicating tabs set at the 
specified columns; 


2. a — followed immediately by an 
integer n, indicating tabs at intervals 
of n columns; 


3. a — followed by the name of a 
““canned”’ tab specification. 


Standard tabs are specified by t-—8, or 
equivalently, t1,9,17,25,etc. The canned 
tabs which are recognized are defined by the 
tabs(1) command. 


ssize The s parameter specifies a maximum line 
size. The value of stze must be an integer. 
Size checking is performed after tabs have 
been expanded, but before the margin is 
prepended. 


mmargin The m parameter specifies a number of 
spaces to be prepended to each line. The 
value of margin must be an integer. 


d The d parameter takes no value. Its 
presence indicates that the line containing 
the format specification is to be deleted 
from the converted file. 
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e The e parameter takes no value. Its 
presence indicates that the current format is 
to prevail only until another format 
specification is encountered in the file. 


Default values, which are assumed for parameters not 
supplied, are t—-8 and mO. If the s parameter is not 
specified, no size checking is performed. If the first line 
of a file does not contain a format specification, the 
above defaults are assumed for the entire file. The 
following is an example of a line containing a format 
specification: 


* <:t5,10,15 s72:> * 
If a format specification can be disguised as a comment, 
it is not necessary to code the d parameter. 


Several CTIX commands correctly interpret the format 
specification for a file. 

SEE ALSO 
ed(1), newform(1), tabs(1). 


NAME 


GETTYDEFS (4) 


gettydefs — speed and terminal settings used by getty 


DESCRIPTION 


The /etc/gettydefs file contains information used by 
peta 1M) to set up the speed and terminal settings for a 
line. It aaa information on what the login prompt 
should look like. It also supplies the speed to try next if 
the user indicates the current speed is not correct by 
typing a <break> character. 


Each entry in /ete/gettydefs has the following format: 


label# initial-flags # final-flags # login-prompt 
#next-label 


Each entry is followed by a blank line. The various 
fields can contain quoted characters of the form \b, \n, 

c, etc., as well as \nnn, where nnn is the octal value of 
the desired character. The various fields are: 


label This is the string against which getty tries 
to match its second argument. It is often 
the speed, such as 1200, at which the 
terminal is supposed to run, but it need 
not be (see below). 


initial-flags | These flags are the initial tocél{2) settings 
to which the terminal is to be set if a 
terminal type is not specified to getty. 
The flags that getty understands are the 
same as the ones _ listed in 
[aes [seaclade (exe) teeeitice h ieee 
termto(7)). Normally only the speed flag 
is required in the tntttal-flags. Getty 
automatically sets the terminal to raw 
input mode and takes care of most of the 
other flags. The inittal-flag settings 
remain in effect until getty executes 
login(1). 


final-flags These flags take the same values as the 
inttial-flags and are set just prior to getty 
executes login. The speed flag is again 
required. The composite flag SANE 
takes care of most of the other flags that 
need to be set so that the processor and 
terminal are communicating in a rational 
fashion. The other two commonly 
specified ftnal-flags are TAB3, so that 
tabs are sent to the terminal as spaces, 
and HUPCL, so that the line is hung up 
on the final close. 


ee 
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login-prompt This entire field is printed as the login- 
prompt. Unlike the above fields where 
white space is ignored (a space, tab or 
new-line), they are included in the log:n- 
prompt field. 


nezt-label If this entry does not specify the desired 
speed, indicated by the user typing a 
<break> character, then getty will 
search for the entry with nezt-label as its 
label field and set up the terminal for 
those settings. Usually, a series of speeds 
are linked together in this fashion, into a 
closed set; for instance, 2400 linked to 
1200, which in turn is linked to 300, 
which finally is linked to 2400. 


If getty is called without a second argument, then the 
first entry of /ete/gettydefs is used, thus making the 
first entry of /eke/ getty dete the default entry. It is 
also used if getty can not find the specified label. If 
/ete/gettydefs itself is missing, there is one entry built 
into the command which will bring up a terminal at 
9600 baud. 


It is strongly recommended that after making or 
modifying /etc/gettydefs, it be run through getty with 
the check option to be sure there are no errors. 


/ete/gettydefs 


SEE ALSO 


getty(1M), login(1), ioctl(2), termio(7). 


NAME 


GPS(4) 


gps — graphical primitive string, format of graphical files 


DESCRIPTION 


GPS is a format used to store graphical data. Several 
routines have been developed to edit and display GPS 
files on various devices. Also, higher level graphics 
programs such as plot (in stat(1G)) and vtoec (in 
toc(1G)) produce GPS format output files. 


A GPS is composed of five types of graphical data or 


primitives. 


GPS PRIMITIVES 


lines 


arc 


text 


hardware 


The lines primitive has a variable number of 
points from which zero or more connected 
line segments are produced. The first point 
given produces a move to that location. (A 
move is a relocation of the graphic cursor 
without arene) Successive points produce 
line segments from the previous point. 
Parameters are available to set color, weight, 
and style (see below). 


The are primitive has a variable number of 
points to which a curve is fit. The first point 
produces a move to that point. If only two 
points are included, a line connecting the 
points will result; if three points a circular arc 
through the points is drawn; and if more than 
three, lines connect the points. (In the 
future, a spline will be fit to the points if 
they number greater than three.) Parameters 
are available to set color, weight, and style. 


The tezt primitive draws characters. It 
requires a single point which locates the 
center of the first character to be drawn. 
Parameters are color, font, teztstze, and 
textangle. 


The hardware primitive draws hardware 
characters or gives control commands to a 
hardware device. A single point locates the 
beginning location of the hardware string. 


comment A comment is an integer string that is 


included in a GPS file but causes nothing to 
be displayed. All GPS files begin with a 
comment of zero length. 
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GPS PARAMETERS 


color 


weight 


style 


font 


textsize 


textangle 


Color is an integer value set for arc, lines, 
and tezt primitives. 


Weight is an integer value set for arc and 
lines primitives to indicate line thickness. 
The value 0 is narrow weight, 1 is bold, and 
2 is medium weight. 


Style is an integer value set for lines and arc 
primitives to give one of the five different 
line styles that can be drawn on TEKTRONIX 
4010 series storage tubes. They are: 

O solid 

1 dotted 

2 dot dashed 

3 = dashed 

4 long dashed 


An integer value set for tezt primitives to 
designate the text font to be used in drawing 
a character string. (Currently font is 
expressed as a four-bit wetghfé value followed 
by a four-bit style value.) 


Textsize is an integer value used in tezt 
primitives to express the size of the 
characters to be drawn. Tertstze represents 
the height of characters in absolute universe- 
untts and is stored at one-fifth this value in 
the size-orientation (so) word (see below). 


Teztangle is a signed integer value used in 
tezt primitives to express rotation of the 
character string around the beginning point. 
Teztangle is expressed in degrees from the 
positive x-axis and can be a positive or 
negative value. It is stored in the size- 
orientation (80) word as a value 256/360 of 
it’s absolute value. 


ORGANIZATION 
GPS primitives are organized internally as follows: 


lines 

are 

text 
hardware 
comment 


cw 


cw potnts sw 

cw points sw 

cw point sw so [string | 

cw point [string | 

cw tateane 

Cw is the control word and begins all 
primitives. It consists of four bits that 


contain a primitive-type code and twelve bits 
that contain the word-count for that 
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point(s) 


sw 


so 


string 


SEE ALSO 
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primitive. 

Point(s) is one or more pairs of integer 
coordinates. Tezt and hardware primitives 
only require a single point. Potnt{s) are 
values within a Cartesian plane or universe 
having 64K (-32K to +32K) points on each 
axis. 


Sw is the style-word and is used in lines, arc, 
and fezt primitives. For all three, eight bits 
contain color information. In are and lines 
eight bits are divided as four bits weight and 
four bits style. In the tezt primitive eight bits 
of sw contain the font. 


So is the size-orientation word used in tezt 
primitives. Eight bits contain text size and 
eight bits contain text rotation. 


String is a null-terminated character string. 
If the string does not end on a _ word 
boundary, an additional null is added to the 
GPS file to insure word-boundary alignment. 


graphics(1G), stat(1G), toc(1G). 
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NAME 
group — group file 
DESCRIPTION 
Group contains for each group the following information: 
group name 
encrypted password 
numerical group ID 
comma-separated list of all users allowed in the group 


This is an ASCII file. The fields are separated by colons; 
each group is separated from the next by a new-line. If 
the password field is null, no password is demanded. 


This file resides in directory /ete. Because of the 
encrypted passwords, it can and does have general read 
permission and can be used, for example, to map 
numerical group ID’s to names. 

FILES 
/etc/group 

SEE ALSO 
newgrp(1), passwd(1), crypt(3C), passwd(4). 


NAME 


HOSTS(4N) 


hosts — list of nodes on network 


DESCRIPTION 


The file /etc/hosts is a list of nodes that share the 
network, including the local node. It is referred to by 
programs which need to translate between node names 
and DARPA Internet addresses. Each line in the file 
describes a single node on the network and consists of 
three fields separated by any number of blanks or tabs: 


address name altas ... 


where 
address 


name 


altases... 


is the DARPA Internet address. 
Unless another type of address is 
required by some node on _ the 
network, address should be a Class 
A address, which takes the form 
net.node, where net is the network 
number from /ete/networks (see 
networks(4)), which must be betwen 
0 and 127; and node is a value 
which must be unique for each node 
and be between 0 and 16777215. 


is the official name of the node. If 
the node is a computer system 
running CTIX , it must claim this 
node name by executing 
setuname(1M) when it is initializing 
itself. 


is a list of alternate names for the 
node. Aliases can be used in 
network commands in place of the 
official name. 


The routines which search this file ignore comments 
(portions of lines beginning with #) and blank lines. 


Internet addresses can actually take one of four forms: 


A 
A.B 


A is a simple 32-bit integer. 

A is an eight-bit quantity occupying 
the high-order byte and B is a 24-bit 
quantity occupying the remaining 
bytes. This form is suitable for a 
Class A address of the form 
net.node. 

A is an eight-bit quantity occupying 
the high-order byte; B is an eight-bit 
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quantity occupying the next byte; 
and C is a 16-bit quantiy occupying 
the remaining bytes. This form is 
suitable for a Class B address of the 
form 128.net.node. 


A.BC.D — The four parts each occupy a byte in 


the address. 
EXAMPLE 
Engineering network 
1.12 — sre net3 # Network Source Machine 
1.10 test net2 # Network Test Machine 
1.16 mifa # Software Development 
1.17 mifb 3# Hardware Development 
FILES 
/etc/hosts 
SEE ALSO 
networks(4N). 


NOTE 


CTIX Internetworking Manual. 


For a discussion of network addresses, see ‘‘Address 
Mappings,’ RFC 796 in the Internet Protocol Transition 


Workbook, March 1982. Network Information Center, 
SRI International, Menlo Park, CA 94025. 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 


INITTAB(4) 


inittab — script for the init process 


DESCRIPTION 


The intttab file is the script to tntt’s role as a general 
process dispatcher. The process that constitutes the 
majority of tntt’s process dispatching activities is the line 
process /etc/getty that initiates individual terminal 
lines. Other processes typically dispatched by tntt are 
daemons and the shell. 


The inittad file is composed of entries that are position 
dependent and have the following format: 


id:rstate:action:process 


Each entry is delimited by a newline, however, a 
backslash (\) preceding a newline indicates a 
continuation of the entry. Up to 512 characters per 
entry are permitted. Comments may be inserted in the 
process field using the sh(1) convention for comments. 
Comments for lines that spawn gettys are displayed by 
the who(1) command. It is expected that they will 
contain some information about the line such as the 
location. There are no limits (other than maximum 
entry size) imposed on the number of entries within the 
tnittab file. The entry fields are: 


td This is one to four characters used to uniquely 
identify an entry. 


retate This defines the run-level in which this entry is 
to be processed. Run-levels effectively 
correspond to a configuration of processes in 
the system. That is, each process spawned by 
tntt is assigned a run-level or run-levels in 
which it is allowed to exist. The run-levels are 
represented by a number ranging from O 
through 6. As an example, if the system is in 
run-level 1, only those entries having a 1 in the 
rstate field will be processed. When init is 
requested to change run-levels, all processes 
which do not have an entry in the rstate field 
for the target run-level will be sent the warning 
signal (SIGTERM) and allowed a 20-second 
grace period before being forcibly terminated 
by a kill signal aes areer The rstate field 
can define multiple run-levels for a process by 
selecting more than one run-level in any 
combination from O-6. If no run-level is 
specified, then the process is assumed to be 
valid at all run-levels O-6. Three other values, 


an 


actton 
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a, b and ¢, can appear in the rstate field, even 
though they are not true run-levels. Entries 
which have these characters in the rstate field 
are processed only when the telinit (see 
tntt(1M)) process requests them to be run 
(regardless of the current run-level of the 
system). They differ from run-levels in that 
intt can never enter run-level a, b orc. Also, a 
request for the execution of any of these 
processes does not change the current run-level. 
Furthermore, a process started by an a, b ore 
command is not killed when intt changes levels. 
They are only killed if their line in 
/etc/inittab is marked off in the action field, 
their line is deleted entirely from /ete/inittab, 
or init goes into the SINGLE USER state. 


Key words in this field tell int¢ how to treat the 
process specified in the process field. The 
actions recognized by intt are as follows: 


respawn If the process does not exist then 
start the process, do not wait for 
its termination (continue 


scanning the inittab file), and 
when it dies restart the process. 
If the process currently exists 
then do nothing and continue 
scanning the tnittad file. 


wait Upon init’s entering the run-level 
that matches the entry’s rstate, 
start the process and wait for its 
termination. All — subsequent 
reads of the tnittad file while init 
is in the same run-level will cause 
tntt to ignore this entry. 


once Upon intt’s entering a run-level 
that matches the entry’s rstate, 
start the process, do not wait for 
its termination. When it dies, do 
not restart the process. If upon 
entering a new run-level, where 
the process is still running from a 
previous run-level change, the 
program will not be restarted. 


boot The entry is to be processed only 
at tnit’s boot-time read of the 
tntttab file. Intt is to start the 
process, not wait for its 
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bootwait 


powerfail 


powerwait 


off 


ondemand 


initdefault 


termination, and when it dies, 
not restart the process. In order 
for this instruction to be 
meaningful, the rstate should be 
the default or it must match 
intt’s run-level at boot time. 
This action is useful for an 
initialization function following a 
hardware reboot of the system. 


The entry is to be processed only 
at intt’s boot-time read of the 
tntttad file. Intt is to start the 
process, wait for its termination 
and, when it dies, not restart the 
process. 


Execute the process associated 
with this entry only when init 
receives a power fail signal 
(SIGPWR see signal(2)). 


Execute the process associated 
with this entry only when init 
receives a power fail signal 
(SIGPWR) and wait until it 
terminates before continuing any 
processing of intttab. 


If the process associated with this 
entry is currently running, send 
the warning signal (SIGTERM) 
and wait 20 seconds before 
forcibly terminating the process 
via the kill signal (SIGKILL). If 
the process is nonexistent, ignore 
the entry. 


This instruction is really a 
synonym for the respawn action. 
It is functionally identical to 
respawn but is given a different 
keyword in order to divorce its 
association with run-levels. This 
is used only with the a, b orc 
values described in the _ rstate 
field. 


An entry with this action is only 
scanned when tntt initially 
invoked. Jnit uses this entry, if it 
exists, to determine which run- 


sysinit 
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level to enter initially. It does 
this by taking the highest run- 
level specified in the rstate field 
and using that as its initial state. 
If the rstate field is empty, this is 
interpreted as 01234586 and so 
tnit will enter run-level 8. Also, 
the initdefault entry cannot 
specify that «init start in the 
SINGLE USER state. 
Additionally, if tntt does not find 
an initdefault entry in 
/ete/inittab, then it will request 
an initial run-level from the user 
at reboot time. 


Entries of this type are executed 
before init tries to access the 
console. It is expected that this 
entry will be only used to 
initialize devices on which init 
might try to ask the run-level 
question. These’ entries are 
executed and waited for before 
continuing. 


process This is a sh command to be executed. The 
entire process field is prefixed with exec and 
passed to a forked 6h as sh -c ‘exec 
command’. For this reason, any legal sh syntax 
can appear in the process field. Comments can 
be inserted with the ; #comment syntax. 


FILES 
/etc/inittab 


SEE ALSO 


getty(1M), init(1M), sh(1), who({1), exec(2), open(2), 


signal(2). 
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NAME 
inode — format of an i-node 
SYNOPSIS 
#include <sys/types.h> 
#include <sys/ino.h> 
DESCRIPTION 
An i-node for a plain file or directory in a file system has 
the following structure defined by <sys/ino.h>. 


/* Inode structure as it appears on a disk block. */ 
struct dinode 


{ 
ushort di_mode; /* mode and type of file */ 
short di_nlink; /* number of links to file */ 
ushort di_uid; /* owner's user id */ 
ushort di.gid; /* owner's group id */ 
off_t di_size; /* number of bytes in file */ 
char di_addr|40]; /* disk block addresses */ 
time_t di_atime; /* time last accessed */ 
time_t di_mtime;/* time last modified */ 
time_t  di_ctime; /# time of last file status change */ 
} 
/* 
* the 40 address bytes: 
* 39 used; 13 addresses 
* of 3 bytes each. 
*/ 


For the meaning of the defined types off_t and time_t 
see types(5). 
FILES 
/usr/include/sys/ino.h 
SEE ALSO 
stat(2), fs(4), types(5). 
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NAME 
issue — issue identification file 


DESCRIPTION 
The file /etc/issue contains the tssue or project 
identification to be printed as a login prompt. This is an 
ASCII file which is read by program getty and then 
written to any terminal spawned or respawned from the 
/etc/inittab file. 


FILES 
/etc /issue 
SEE ALSO 
login(1). 
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NAME 


LDFOCN(4) 


Idfen — common object file access routines 


SYNOPSIS 


#tinclude <stdio.h> 
#tinclude <filehdr.h> 
#iinclude <Idfen.h> 


DESCRIPTION 


The common object file access routines are a collection 
of functions for reading an object file that is in common 
object file form. Although the calling program must 
know the detailed structure of the parts of the object file 
that it processes, the routines effectively insulate the 
calling program from knowledge of the overall structure 
of the object file. 


The interface between the calling program and the 
object file access routines is based on the defined type 
LDFILE, defined as struct Idfile, declared in the header 
file Idfen.h. The primary purpose of this structure is to 
provide uniform access to both simple object files and to 
object files that are members of an archive file. 


The function Idopen(3X) allocates and initializes the 
LDFILE structure and returns a pointer to the structure 
to the calling program. The fields of the LDFILE 
structure may be accessed individually through macros 
defined in Idfen.h and contain the following 
information: 


LDFILE *ldptr; 


TYPE(Idptr) The file magic number, used to 
distinguish between archive members 
and simple object files. 


OPTR(Idptr) The file pointer returned by fopen and 
used by the standard input/output 
functions. 

OFFSET(Idptr) The file address of the beginning of the 
object file; the offset is non-zero if the 
object file is a member of an archive 
file. 

HEADER(Idptr) The file header structure of the object 
file. 

The object file access functions themselves may be 

divided into four categories: 


(1) functions that open or close an object file 
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idopen (ex) and Idaopen 
pen a common object file 
Idelose(3X) and Idaclose 


close a common object file 


(2) functions that read header or symbol table 
information 


Idahread(3X) 
read the archive header of a member of 
an archive file 

Idfhread(3X) 
read the file header of a common object 
file 

Idshread(3X ‘ and Idnshread 
read a section header of a common 
object file 

Idtbread(3X) 
read a symbol table entry of a common 
object file 

ldgetname(3X) 
retrieve a symbol name from a symbol 
table entry or from the string table 


(3) functions that position an object file at (seek to) the 
start of the section, relocation, or line number 
information for a particular section. 


Idohseek(3X) 
seek to the optional file header of a 
common object file 
Idsseek(3X) and Idnsseck 
seek to a section of a common object file 
Idrseek(3X) and Idnrseek 
seek to the relocation information for a 
section of a common object file 
Idiseek(3X) and Idnlseek 
seek to the line number information for 
a section of a common object file 
Idtbseek(3X) 
seek to the symbol table of a common 
object file 


(4) the function Idtbindez(3X) which returns the index of 
a particular common object file symbol table entry. 


These functions are described in detail on their 
respective manual pages. 


All the functions except ceopen ts Idgetname(3X), 
Idaopen (8X), and Idtbindez return Arie: 
SUCCESS or FAILURE, both oats defined in 
Idfen.h. Ldopen and Idaopen both return pointers to a 
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LDFILE structure. 


Additional access to an object file is provided through a 
set of macros defined in Idfen.h. These macros parallel 
the standard input/output file reading and manipulating 
functions, translating a reference of the LDFILE 
structure into a reference to its file descriptor field. 


The following macros are provided: 


GETC Mate 
FGETC(ldptr) 
GET ae 
UNGETO(c, ldptr 

FGETS(s, n, Idptr 

FREAD (char *) ptr, sizeof (*ptr), nitems, ldptr) 
FSEEK (ldptr, offset, se 

FTELL/(ldptr) 

REWIND(Idptr) 

FEOF Se itdote} 

FERR oy 

FILENO( nents 

SETBUF(Idptr, buf 

STROFF oot doen 


The STROFFSET macro calculates the address of the 
string table in an object file. See the manual entries for 
the corresponding standard input/output library 
functions for details on the use of the rest of the macros. 


The program must be loaded with the object file access 
routine library libld.a. 


WARNING 
The macro FSEEK defined in the header file Idfen.h 
translates into a call to the standard input/output 
function feeek(3S). FSEEK should not be used to seek 
from the end of an archive file since the end of an 
archive file may not be the same as the end of one of its 
object file members! 


SEE ALSO 


fseek(3S), Idahread(3X), Idclose(3X), Idgetname(3X), 
ldfhread(3X), Idlread(3X), Idlseek(3X), Idohseek(3X), 
Idopen(3X), Idrseek(3X), Idlseek(3X), —Idshread(3X), 


Idtbindex(3X), ldtbread(3X), ldtbseek(3X). 
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NAME 
linenum — line number entries in a common object file 
SYNOPSIS 
#include <linenum.h> 
DESCRIPTION 
Compilers based on pee generate an entry in the object 
file for each C source line on which a breakpoint is 
possible (when invoked with the —g option; see cc(1)). 
Users can then reference line numbers when using the 
appropriate software test system (see set) The 
structure of these line number entries appears below. 
struct lineno 
union 
long l_symndx ; 
long l_paddr ; 
l_addr ; 
unsigned short ]_Inno ; 
Numbering starts with one for each function. The initial 
line number entry for a function has |_Inno equal to zero, 
and the symbol table index of the function’s entry is in 
l_symndz. Otherwise, /_Inno is non-zero, and |_paddr is 
the physical address of the code for the referenced line. 
Thus the overall structure is the following: 
addr lInno 
function symtab index 0 
physical address line 
physical address line 
function symtab index 0 
physical address line 
physical address line 
SEE ALSO 


ec(1), sdb(1), a.out(4). 
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NAME 
master — master device information table 


DESCRIPTION 

This file is used by the config(1M) program to obtain 
device information that enables it to generate the 
configuration files. Do not modify it unless you fully 
understand its construction. The file consists of 3 parts, 
each separated by a line with a dollar sign ($) in column 
1. Part 1 contains device information; part 2 contains 
names of devices that have aliases; part 3 contains 
tunable parameter information. Any line with an 
asterisk (*) in column 1 is treated as a comment. 


Part 1 contains lines consisting of 7 or 10 fields, with the 
fields delimited by tabs and/or blanks: 


Field 1: device name (8 chars. maximum). 
Field 2: device mask (octal)-each ‘‘on” bit 
indicates that the handler exists: 
001000 has release handler for 
downloadable drivers 
000200 tty header exists 
000100 initialization handler 
000040 power-failure handler 
000020 open handler 
000010 close handler 
000004 read handler 
000002 write handler 
000001 ioctl handler. 
Field 3: device type indicator (octal): 
001000 cluster device 
000400 VME device 
000200 allow only one of these devices 
000040 suppress interrupt vector 
000020 required device 
000010 block device 
000004 character device 
600002 floating vector 
000001 fixed vector. 


Field 4: handler prefix (4 chars. maximum). 

Field 5: major device number for block-type 
device. 

Field 6: major device number for character-type 
device. 

Field 7: maximum number of devices on system. 

Field 8: device vector size. 

Field 9: device address type ae modifier). 

Field 10: device interrupt level. 
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Part 2 contains lines with 2 fields each: 

Field 1: alias name of device (8 chars. maximum). 

Field 2: reference name of device (8 chars. 
maximum; specified in part 1). 

Part 3 contains lines with 2 or 3 fields each: 


Field 1: parameter name (as it appears in 
description file; 20 chars. maximum) 

Field 2: parameter name (as it appears in the 
conf.c file; 20 chars. maximum) 

Field 3: default parameter value (20 chars. 


maximum; parameter specification is 
required if this field is omitted) 
FILES 
/etc/master 
SEE ALSO 
config(1M). 
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NAME 

mnttab — mounted file system table 
SYNOPSIS 

#include <mnttab.h> 
DESCRIPTION 


Mnttab resides in directory /ete and contains a table of 
devices, mounted by the mount(1M) command, in the 
following structure as defined by <mnttab.h>: 


struct mnttab { 


char mt_dev([32]; 
char mt_filsys[32]; 
short mt_ro_flg; 
time_t mt_time; 


}s 
Each entry is 70 bytes in length; the first 32 bytes are 
the null-padded name of the place where the special file 
is mounted; the next 32 bytes represent the null-padded 
root name of the mounted special file; the remaining 6 
bytes contain the mounted spectal file’s read/write 
permissions and the date on which it was mounted. 


The maximum number of entries in mnttab is based on 
the system parameter NMOUNT located in 
/usr/sre/uts/cf/conf.c, which defines the number of 
allowable mounted special files. 


SEE ALSO 
mount(1M), setmnt(1M). 
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NAME 


networks — names and numbers for the internet 


DESCRIPTION 


The file /ete/networks lists networks on the internet. 
Each line describes a single network and consists of the 
following blank separated fields: 


name number aliases ... 


where 
name 


number 


aliases... 


EXAMPLE 


is the official name of the network. 
All nodes on the internet should use 
the same official name for a given 
network. 


is the network number, which 
serves as part of the DARPA 
Internet address for each node on 
the internet. All nodes on the 
internet must use the same number 
for a given network. 


is a blank-separated list of local 
aliases for the network. 


The routines which search this file 
ignore comments (portions of lines 
beginning with #) and blank lines. 


# Building 1 Internet 
&D 


Engineering 1 


Production 2. #Administration, etc. 


SEE ALSO 
hosts(4N). 


CTIX Internetworking Manual. 


FILES 
/etc/networks 


NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 


PASSWD (4) 


passwd — password file 


DESCRIPTION 


Passwd contains for each user the following information: 


login name 

encrypted password 
numerical user ID 
numerical group ID 

user name 

initial working directory 
program to use as Shell 


This is an ASCII file. Each field within each user’s entry 
is separated from the next by a colon. Each user is 
separated from the next by a new-line. If the password 
field is null, no password is demanded; if the Shell field 
is null, /bin/sh is used. 


This file resides in directory /ete. Because of the 
encrypted passwords, it can and does have general read 
permission and can be used, for example, to map 
numerical user IDs to names. 


The encrypted password consists of 13 characters chosen 
from a 64-character alphabet (., /, O-9, A—Z, a~z), 
except when the password is null, in which case the 
encrypted password is also null. Password aging is 
effected for a particular user if his encrypted password in 
the password file is followed by a comma and a non-null 
string of characters from the above alphabet. (Such a 
string must be introduced in the first instance by the 
super-user.) 


The first character of the age, M say, denotes the 
maximum number of weeks for which a password is 
valid. A user who attempts to login after his password 
has expired will be forced to supply a new one. The next 
character, m say, denotes the minimum period in weeks 
which must expire before the password may be changed. 
The remaining characters define the week (counted from 
the beginning of 1970) when the password was last 
changed. (A null string is equivalent to zero.) M and m 
have numerical values in the range 0-63 that correspond 
to the 64-character alphabet shown above (i.e., / = 1 
week; s = 63 weeks). If m = M = 0 (derived from the 
string . or ..) the user will be forced to change his 
password the next time he logs in (and the “age” will 
disappear from his entry in the password file). If m > 
M (signified, e.g., by the string ./) only the super-user 
will be able to change the password. 


Bea ee 
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FILES 
/etc/passwd 
SEE ALSO 


1641(3C), login(1), passwd(1), a641(3C), crypt(3C), 
getpwent(3C), aruba): 


NAME 


PLOT (4) 


plot — graphics interface 


DESCRIPTION 


Files of this format are produced by routines described in 
plot(3X) and are interpreted for various devices by 
commands described in tplot(1G). A graphics file is a 
stream of plotting instructions. Each instruction consists 
of an ASCII letter usually followed by bytes of binary 
information. The instructions are executed in order. A 
point is designated by four bytes representing the x and 
y values; each value is a signed integer. The last 
designated point in an 1, m, n, or p instruction becomes 
the ‘‘current point’’ for the next instruction. 


Each of the following descriptions begins with the name 
of the corresponding routine in plot(3X). 


m move: The next four bytes give a new current point. 


n cont: Draw a line from the current point to the point 
given by the next four bytes. See tplot(1G). 


p point: Plot the point given by the next four bytes. 


1 tine: Draw a line from the point given by the next 
four bytes to the point given by the following four 
bytes. 


t label: Place the following ASCII string so that its 
first character falls on the current point. The string 
is terminated by a new-line. 


e erase: Start another frame of output. 


f linemod: Take the following string, up to a new-line, 
as the style for drawing further lines. The styles are 
“dotted”’, “solid”, ‘“longdashed’’, ‘‘shortdashed’’, and 
‘“dotdashed”. Effective only for the —T4014 and 
—Tver options of tplot(1G) (TEKTRONIX 4014 
terminal and Versatec plotter). 


s space: The next four bytes give the lower left corner 
of the plotting area; the following four give the upper 
right corner. The plot will be magnified or reduced 
to fit the device as closely as possible. 


Space settings that exactly fill the plotting area with 
unity scaling appear below for devices supported by the 
filters of tplot(1G). The upper limit is just outside the 
plotting area. In every case the plotting area is taken to 
be square; points outside may be displayable on devices 
whose face is not square. 


DASI 300 space(0, 0, 4096, 4096); 
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DASI 300s space(0, 0, 4096, 4096); 
DASI 450 space(0, 0, 4096, 4096): 
TEKTRONIX 4014  space(0, 0, 3120, 3120); 
Versatec plotter space(0, 0, 2048, 2048); 


SEE ALSO 
graph(1G), tplot(1G), plot(3X), gps(4), term(5). 
WARNING 
The plotting library plot(3X) and the curses library 
curses(3X) both use the names erase() and move(). The 
curses versions are macros. If you need both libraries, 
put the plot(3X) code in a different source file than the 


curses(3X) code, and/or #undef move() and erase() in 
the plot(3X) code. 


NAME 


PROFILE(4) 


profile — setting up an environment at login time 


DESCRIPTION 


FILES 


If the file /ete/profile exists, it will be executed for 
every Bourne shell user immediately upon login. After 
this, if the user’s login directory contains a file named 
-profile, that file will be be executed (via . .profile) 
before the user’s session begins. The .profile is useful 
for exporting environment variables and terminal modes. 


The following example is typical for a user’s .profile file: 


PATH=:$PATH:$HOME/bin 
MAIL=/usr/mail/myname 
TERM=pt 

export PATH MAIL TERM 
umask 022 


The system file /etc/profile can be customized to set 
the TERM environment variable via tset(1) and to 
automatically invoke wm(1) on RS-422 terminals. 


Shell environment variables that can be set are described 
in sh(1). 


$HOME/.profile 
/etc/profile 


SEE ALSO 


esh(1), cprofile(4), env(1), login(1), mail(1), sh(1), stty(1), 
oul) tset(1), wm(1), ttytype(4), environ(5), term(5). 
MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 


PROTOCOLS(4N) 


NAME 
protocols — list of Internet protocols 
DESCRIPTION 
The file /etc/protocols lists known DARPA Internet 


protocols. Each line describes a single protocol and 
consists of the following blank separated fields: 


name number aliases ... 


where 

name is the official name of the protocol. 

number is the protocol number. 

aliases... is a blank-separated list of local aliases for 


the protocol. 


The routines which search this file ignore comments 
(portions of lines beginning with #) and blank lines. 


Protocol names and numbers are specified by the SRI 
Network Information Center. Do not change this file 
unless you are familiar with DARPA Internet internals. 


FILES 
/etc/protocols 


SEE ALSO 
CTIX Internetworking Manual. 


NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 

reloc — relocation information for a common object file 
SYNOPSIS 

#include <reloc.h> 
DESCRIPTION 


Object files have one relocation entry for each 
relocatable reference in the text or data. If relocation 
information is present, it will be in the following format. 


struct reloc 


long r_vaddr ; 

/* (virtual) address of reference */ 
long r_symndx ; 

/* index into symbol table */ 
short r_type ; /* relocation type */ 


* 
* All generics 
* reloc. already performed to symbol in the same section 


* 
#define R_ABS 0 


* 
*Motorola Processors 68000, 68010, and 68020 


* 
* 


#define R_DIR24 04 
#define R_REL24 05 
#define RLOPT16 014 
#define R_IND24 015 
#define R_IND32 016 


#define RILRELBYTE 017 
#define RIRELWORD 020 
#define RLRELLONG 021 
#define RLPCRBYTE 022 
#define RIPCRWORD 023 
#define RPPCRLONG 024 


As the link editor reads each input section and performs 
relocation, the relocation entries are read. They direct 
how references found within the input section are 
treated. 
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R_ABS The reference is absolute, and no relocation 
is necessary. The entry will be ignored. 


R_DIR24 A direct, 24-bit reference to a symbol’s 
virtual address. 


R_REL24 A “PC-relative”’, 24-bit reference to a 
symbol’s virtual _ address. Relative 
references occur in instructions such as 
jumps and calls. The actual address used 
is obtained by adding a constant to the 
value of the program counter at the time 
the instruction is executed. 


R_OPT16 An optimized, indirect, 16-bit reference 
through a transfer vector. The instruction 
contains the offset into the transfer vector 
table to the transfer vector where the 
actual address of the referenced word is 
stored. 

R_IND24 An indirect, 24-bit reference through a 
transfer vector. The instruction contains 
the virtual address of the transfer vector, 
where the actual address of the referenced 
word is stored. 

R_IND32 An indirect, 32-bit reference through a 
transfer vector. The instruction contains 
the virtual address of the transfer vector, 
where the actual address of the referenced 
word is stored. 

R_RELBYTE A direct 8-bit reference to a symbol’s 
virtual address. 

R_RELWORD 
A direct 16-bit reference to a symbol’s 
virtual address. 


R_RELLONG A direct 32-bit reference to a symbol’s 
virtual address. 


R_PCRBYTE A “PC-relative’”’, 8-bit reference to a 
symbol’s virtual address. 


R_PCRWORD 
A “PC-relative”’, 16-bit reference to a 
symbol’s virtual address. 


R_PCRLONG A “PC-relative’, 32-bit reference to a 
symbol’s virtual address. 


On the VAX processors relocation of a symbol index of -1 
indicates that the relative difference between the current 
segment’s start address and the program’s load address is 
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added to the relocatable address. 


Other relocation types will be defined as they are 
needed. 


Relocation entries are generated automatically by the 
assembler and automatically utilized by the link editor. 
A link editor option exists for removing the relocation 
entries from an object file. 


SEE ALSO 
1d(1), strip(1), a.out(4), syms(4). 


NAME 


RHOSTS(4N) 


rhosts — remote equivalent users 


DESCRIPTION 


FILES 


These files grant permission for remote users to use local 
user names without knowing the corresponding user 
passwords. This is known as making the remote user 
“‘equivalent” to the local user. This is convenient, for 
example, when one person owns user names on more 
than one node. 


If a user’s home directory contains a file named .rhosts, 
remote users specified in the file are equivalent to the 
local user. Each user specification in the file consists of 
the remote user node name and user name, separated by 
a space. For security reasons, .rhosts must belong to 
the user granting the equivalence or to root. 


The file /etc/hosts.equiv is a list of remote nodes with 
matching-name equivalence. The file lists remote nodes 
one per line. On each node listed in /etc/hosts.equiv, 
a remote user with the same name as a local user is 
equivalent to the local user. In effect, the users are the 
same if the names are the same. 


$HOME/.rhosts 
/etc/hosts.equiv 


SEE ALSO 


remd(1N), rep(1N), rlogin(1N). 
CTIX Internetworking Manual. 


WARNINGS 


NOTE 


When a system is listed in /etc/hosts.equiv, its 
security must be as good as local security. 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
sccsfile — format of SCCS file 


DESCRIPTION 

An SCCS file is an ASCII file. It consists of six logical 
parts: the checksum, the delta table contains 
information about each aclie) user names oe 
login names and/or numerical group IDs of users who 
may add deltas), flags (contains definitions of internal 
keywords), comments (contains arbitrary descriptive 
information about the file), and the body (contains the 
actual text lines intermixed with control lines). 


Throughout an SCCS file there are lines which begin with 
the ASCII SOH (start of heading) character (octal 001). 
This character is hereafter referred to as the control 
character and will be represented graphically as @. 
Any line described below which is not depicted as 
beginning with the control character is prevented from 
beginning with the control character. 


Entries of the form DDDDD represent a five-digit string 
(a number between 00000 and 99999). 


Each logical part of an SCCS file is described in detail 
below. 


Checksum 
The checksum is the first line of an SCCS file. 
The form of the line is: 
@hDDDDD 


The value of the checksum is the sum of all 
characters, except those of the first line. The 
@h provides a magtc number of (octal) 064001. 


Delta table 
The delta table consists of a variable number of 
entries of the form: 


@s DDDDD/DDDDD/DDDDD 

@d <type> <SCCSID> yr/mo/da hr:mi:se 
<pgmr> DDDDD DDDDD 

@i DDDDD ... 

@x DDDDD ... 

@g DDDDD ... 

@m <MR number> 


@e <comments> ... 
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@e 

The first line (@s) contains the number of lines 
inserted/deleted/unchanged, respectively. The 
second line (@d) contains the type of the delta 
(currently, normal: D, and removed: R), the 
SCCS ID of the delta, the date and time of 
creation of the delta, the login name 
corresponding to the real user ID at the time the 


delta was created, and the serial numbers of the 
delta and its predecessor, respectively. 


The @i, @x, and @g lines contain the serial 
numbers of deltas included, excluded, and 
ignored, respectively. These lines are optional. 


The @m lines (optional) each contain one MR 
number associated with the delta; the @e lines 
contain comments associated with the delta. 


The Ge line ends the delta table entry. 


User names 


Flags 


The list of login names and/or numerical group 
IDs of users who may add deltas to the file, 
separated by new-lines. The lines containing 
these login names and/or numerical group IDs 
are surrounded by the bracketing lines @u and 
@U. An empty list allows anyone to make a 
delta. Any line starting with a ! prohibits the 
succeeding group or user from making deltas. 


Keywords used internally (see admin(1) for more 
information on their use). Each flag line takes 
the form: 


@f <flag> <optional text > 


The following flags are defined: 


@f t <type of program > 
@fv <program name> 
@f i <keyword string > 
@f b 

@fm <module name> 
@f f < floor > 

@f c <ceiling > 

@fd <default-sid> 
@fn 
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Of j 

@f | <lock-releases > 

@fq <user defined> 

@f z <reserved for use in interfaces > 


The t flag defines the replacement for the %Y% 
identification keyword. The v flag controls prompting 
for MR numbers in addition to comments; if the optional 
text is present it defines an MR number validity 
checking program. The i flag controls the warning/error 
aspect of the ‘No id keywords’? message. When the i 
flag is not present, this message is only a warning; when 
the i flag is present, this message will cause a ‘“‘fatal”’ 
error (the file will not be gotten, or the delta will not be 
made). When the b flag is present the —b keyletter may 
be used on the get command to cause a branch in the 
delta tree. The m flag defines the first choice for the 
replacement text of the %M% identification keyword. 
The f flag defines the “floor” release; the release below 
which no deltas may be added. The c flag defines the 
‘‘ceiling” release; the release above which no deltas may 
be added. The d flag defines the default SID to be used 
when none is specified on a get command. The n flag 
causes delta to insert a ‘“‘null” delta (a delta that applies 
no changes) in those releases that are skipped when a 
delta is made in a new release (e.g., when delta 5.1 is 
made after delta 2.7, releases 3 and 4 are skipped). The 
absence of the n flag causes skipped releases to be 
completely empty. The j flag causes get to allow 
concurrent edits of the same base SID. The | flag defines 
a list of releases that are locked against editing (get(1) 
with the -—e keyletter). The q flag defines the 
replacement for the %Q% identification keyword. The 
z flag is used in certain specialized interface programs. 


Comments 
Arbitrary text is surrounded by the bracketing 
lines @t and @T. The comments section 
typically will contain a description of the file’s 
purpose. 


Body 
The body consists of text lines and control lines. 
Text lines do not begin with the control 
character, control lines do. There are three 
kinds of control lines: insert, delete, and end, 
represented by: 


@I DDDDD 
@D DDDDD 


“Ze 
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GE DDDDD 


respectively. The digit string is the serial 
number corresponding to the delta for the 
control line. 


SEE ALSO 
admin(1), delta(1), get(), prs(1). 
TIX Programmer’s Guide, Section 9. 
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NAME 
scnhdr — section header for a common object file 
SYNOPSIS 
#include <scnhdr.h> 
DESCRIPTION 
Every common object file has a table of section headers 
to specify the layout of the data within the file. Each 
section within an object file has its own header. The C 
structure appears below. 


struct senhdr 


{ 
char s_name|SYMNMLEN]; /* section name */ 
long s.paddr; /* physica] address */ 
long s_vaddr; /* virtual address */ 
long s_size; /* section size */ 
long s.scnptr; /* file ptr to raw data */ 
long s_relptr; /* file ptr to relocation */ 
long s_|nnoptr; /* file ptr to line numbers */ 
unsigned short s_nreloc; /* # reloc entries */ 
unsigned short s_ninno; /* # line number entries */ 
long s_flags; /* flags */ 

}3 


File pointers are byte offsets into the file; they can be 
used as the offset in a call to fseek(3S). If a section is 
initialized, the file contains the actual bytes. An 
uninitialized section is somewhat different. It has a size, 
symbols defined in it, and symbols that refer to it. But 
it can have no relocation entries, line numbers, or data. 
Consequently, an uninitialized section has no raw data in 
the object file, and the values for s_senptr, s_relptr, 
s_lnnoptr, s_nreloc, and s_ninno are zero. 


SEE ALSO 
1d(1), fseek(3S), a.out(4). 


SERVICES ( 4N) 


NAME 
services — list of Internet services 
DESCRIPTION 
The file pote services lists known DARPA Internet 


services. Each line describes a single service and consists 
of the following blank separated fields: 


name number /protocol aliases ... 


where 
name is the official name of the service. 
number is the service number. 
protocol is the name of the protocol (see 
protocols(4N)) used by the service. 
aliases... is a blank-separated list of local 


aliases for the service. 
The routines which search this file ignore comments 
(portions of lines beginning with #) and blank lines. 


Service names and numbers are specified by the SRI 
Network Information Center. Do not change this file 
unless you are familiar with DARPA Internet internals. 
FILES 
/etc/services 
SEE ALSO 
CTIX Internetworking Manual. 
NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 

syms — common object file symbol table format 
SYNOPSIS 

#include <syms.h> 
DESCRIPTION 


Common object files contain information to support 
symbolic software testing (see sdb(1)). Line number 
entries, linenum(4), and extensive symbolic information 
permit testing at the C source level. Every object file’s 
symbol table is organized as shown below. 


File name 1. 
Function 1. 
Local symbols for function 1. 
Function 2. 
Local symbols for function 2. 


Static externs for file 1. 


File name 2. 
Function 1. 
Local symbols for function 1. 
Function 2. 
Local symbols for function 2. 


Static externs for file 2. 


Defined global symbols. 
Undefined global symbols. 


The entry for a symbol is a fixed-length structure. The 
members of the structure hold the name (null padded), 
its value, and other information. The C structure 1s 
given below. 


#define SYMNMLEN 8 
#define FILNMLEN 14 
#define DIMNUM 4 


struct syment 


{ 


union /* all ways to get symbol name */ 
{ 
char _n_name|[SYMNMLEN]; /* symbol name */ 
struct| 
{ 
long _N_zeroes; /* == OL when in string table */ 
long _h_offset; /* location of name in table */ 
} _n_n; 
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char _n_nptr|2); /* allows overlaying «/ 

} an; 

long _—n_value; /* value of symbol #/ 

short n_scnum; /* section number */ 

unsigned short n_type; /* type and derived type */ 

char _n_sclass; /* storage class */ 

char  n_numaux; /* number of aux entries */ 
}; 
#define n_name  _n._n_name 


#define n_zeroes n._N_n._n_zeroes 


#define n_offset n._n_n._n_offset 


#define nnptr _n._n_nptr(1] 

Meaningful values and explanations for them are given in 
both syms.h and Common Object File Format. Anyone 
who needs to interpret the entries should seek more 
information in these sources. Some symbols require more 
information than a single entry; they are followed by 
auziliary entries that are the same size as a symbol 
entry. The format follows. 


union auxent 


struct 
long x_tagndx; 
union 
struct 
unsigned shortx_Inno; 
unsigned shortx_size; 
} x_Insz; 
ong x_fsize; 
} x_mise; 
union 
struct 
long x_Innoptr; 
long x_endndx; 
} x_fen; 
struct 
unsigned shortx_dimen[DIMNUM]; 
} X_ary; 
x_fenary; 
unsigned short x_tvndx; 
} x_sym; 
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struct 


char x_fname[FILNMLEN]; 
} x_file; 
struct 


long x_scnlen; 
unsigned short x_nreloc; 
unsigned short x_nlinno; 


} x_scn; 
struct 
long x_tvfill; 
unsigned short x_tvlen; 
unsigned short x_tvran(2]; 
} x_tv; 


}; 
Indexes of symbol table entries begin at zero. 


SEE ALSO 
sdb(1), a.out(4), linenum(4). 


CAVEATS 
CTIX C longs are equivalent to ints and are converted to 
ints in the compiler to minimize the complexity of the 
compiler code generator. Thus the information about 
which symbols are declared as longs and which, as ints, 
does not show up in the symbol table. 


NAME 


SYSTEM( 4) 


system — system description file 


DESCRIPTION 


The system description describes tunable variables and 
hardware configuration to the CTIX system. 


The file is formatted in sections. Each section begins 
with a section header (a ! followed by a single word). 
Each section varies in format, depending upon the 
format required by the program that uses the data 
provided by that section. 


In the example file the }WMESLOTS section describes 
the VME boards for the EEPROM. The slot field is the 
slot position in the VME bus. The type field is the board 
type; board types may be: 


1 CMC Ethernet board 
2 Interphase SMD disk controller board 
3 Xylogics 1/2-inch tape controller board 


The address field is the location of the board. The 
length field is the address space size of the board. The 
optional initialization function name is an initialization 
function that is called by the PROM at boot time. 


The !VMECODE section consists of a list of files that 
describe the executable code to be loaded into the 
EEPROM. This section is required only if a bootable 
initialization function was specified. 


EXAMPLE 
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FILENAMES 
PROM_IFILE=/etc/lddrv/EEPROM .ifile 
EEPROM_FILE=/dev/vme/eeprom 
INIT_CFILE=tunevar.c 

!'VMESLOTS 

é The following section describes the VME boards 


*slot type address length (Initialization 
. function name | 
* 
0 2 ©1000000 512 init Vs32 
1 2 C1000200 512 
*one CMC Ethernet controller) 
2 1 CODE0200 131072 
* 
IVMECODE 
diskvs32.0 
oe 
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SEE ALSO 
lddrv(1M), Ideeprom(1M), mktunedrv(1M), vme(7). 
MightyFrame Administrator’s Reference Manual. 
FILES / 
/etc/system 
/dev/vme/eeprom 
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NAME 


TERM(4) 


term — format of compiled term file. 


SYNOPSIS 


term 


DESCRIPTION 


5/86 


Compiled terminfo descriptions are placed under the 
directory /usr/lib/terminfo. In order to avoid a linear 
search of a huge CTIX system directory a two-level 
scheme is used: /usr/lib/terminfo/c/name where 
name is the name of the terminal, and c is the first 
character of name. Thus, act4 can be found in the file 
/usr/lib/terminfo/a/act4. Synonyms for the same 
terminal are implemented by multiple links to the same 
compiled file. 


The format has been chosen so that it will be the same 
on all hardware. An 8 or more bit byte is assumed, but 
no assumptions about byte ordering or sign extension are 
made. 


The compiled file is created with the tic(1M) program, 
and read by the routine setupterm. Both of these pieces 
of software are part of curses(3X). The file is divided 
into six parts: the header, terminal names, boolean flags, 
numbers, strings, and string table. 


The header section begins the file. This section contains 
six short integers in the format described below. These 
integers are (1) the magic number (octal 0432); (2) the 
size, in bytes, of the names section; (3) the number of 
bytes in the boolean section; (4) the number of short 
integers in the numbers section; (5) the number of offsets 
(short integers) in the strings section; (6) the size, in 
bytes, of the string table. 


Short integers are stored in two 8-bit bytes. The first 
byte contains the least significant 8 bits of the value, 
and the second byte contains the most significant 8 bits. 
(Thus, the value represented is 256*second-+first.) The 
value —1 is represented by 0377, 0377; other negative 
values are illegal. The -1 generally means that a 
capability is missing from this terminal. Note that this 
format corresponds to the hardware of the VAX and 
PDP-11. Machines where this does not correspond to the 
hardware read the integers as two bytes and compute the 
result. 


The terminal names section comes next. It contains the 
first line of the terminfo description, listing the various 
names for the terminal, separated by the ‘|’ character. 
The section is terminated with an ASCII NUL character. 
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The boolean flags have one byte for each flag. This byte 
is either 0 or 1 as the flag is present or absent. The 
capabilities are in the same order as the file <term.h>. 


Between the boolean section and the number section, a 
null byte will be inserted, if necessary, to ensure that the 
number section begins on an even byte. All short 
integers are aligned on a short word boundary. 


The numbers section is similar to the flags section. Each 
capability takes up two bytes, and is stored as a short 
integer. If the value represented is —1, the capability is 
taken to be missing. 


The strings section is also similar. Each capability is 
stored as a short integer, in the format above. A value 
of -1 means the capability is missing. Otherwise, the 
value is taken as an offset from the beginning of the 
string table. Special characters in “X or \c notation are 
stored in their interpreted form, not the printing 
representation. Padding information $<nn> _ and 
parameter information %x are stored intact in 
uninterpreted form. 


The final section is the string table. It contains all the 
values of string capabilities referenced in the string 
section. Each string is null terminated. 


Note that it is possible for setupterm to expect a 
different set of capabilities than are actually present in 
the file. Either the database may have been updated 
since setupterm has been recompiled (resulting in extra 
unrecognized entries in the file) or the program may 
have been recompiled more recently than the database 
was updated (resulting in missing entries). The routine 
setupterm must be prepared for both possibilities — this 
is why the numbers and sizes are included. Also, new 
capabilities must always be added at the end of the lists 
of boolean, number, and string capabilities. 


As an example, an octal dump of the description for the 
Microterm ACT 4 is included: 


microterm|act4|microterm act iv, 
cr="M, cudl=“*J, ind=*J, bel=“G, am, cubl=‘H, 
ed=*_, el=**, clear=*L, cup=*T%p1%c%p2%c, 
cols#80, lines#24, cufl=“X, cuul=*Z, home="], 


FILES 
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000032001 \0025 \O \b \0212 \0 "\0 mie r 

020 o t e r mj] act 4{i{miero 

040 t e r m act iv \O \o001 \o \oO 

060 \O0 \O \o \o \o \o \o \o \O \o \o \o \O \o \o \o 

100 \0 \O P \0 377 377 030 \0 377 377 377 377 377 377 377 377 
120 377 377 377 377 \O \0 002 \0 377 377 377 377 004 \0 006 \0 
140 \b \0 377 377 377 377 \n \0.026 \0 030 \0 377 377 032 \0 
160 377 377 377 377 034 \0 377 377 036 \0 377 377 377 377 377 377 
200 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 
* 

520 377 377 377 377 \0 377 377 377 377 377 377 377 377 377 377 
540 377 377 377 377 377 377 007 \O \r \O \f \0 036 \0 037 \o 
560024 % p 1% « % p 2 % ¢ \O \n \0 035 \0 
600 \b \0 030 \0 032 \o \n \o 


Some limitations: total compiled entries cannot exceed 
4096 bytes. The name field cannot exceed 128 bytes. 


/usr/lib/terminfo/*/* compiled terminal capability 
data base 


SEE ALSO 


curses(3X), terminfo(4). 
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NAME 

termcap — terminal capability data base 
SYNOPSIS 

/etc/termeap 
DESCRIPTION 


This entry describes terminal-independent programming 
conventions that originate at UC Berkeley. UNIX System 
V initially borrowed termcap but has since changed to 
the terminfo(4) convention. CTIX continues to support 
termcap so as to be compatible with the Berkeley version 
of the UNIX System. But use terminfo in new programs. 


Termcap programs work from information supplied 
through the TERM and TERMCAP environment 
variables. The location of the description depends on 
the value of TERMCAP: 


e If TERMCAP is not set or is empty, TERM 
is the name of an description in /ete/termcap. 
e If TERMCAP has a value that begins with a /, 


TERM is the name of an description in the file 
named by TERMCAP. 


e If TERMCAP begins with any character 
except /, TERMCAP contains the description. 


A description begins with a list of its names, separated 
by vertical bars. The rest of the description is a list of 
capabilities, separated by colons. If you use more than 
one line, precede each newline except the last with :\ 
Here’s a simple example. 


dpivertidec vt50: as 
bs:c Seis J:ce=\EK: cl=\EH\EJ: co#80:i#12:\ 
nd= \EC:pt:up=\EA: 
There are three kinds of capabilities: 


° Boolean. These indicate the presence or absence 
of a terminal feature by their presence or 
absence. Boolean capabilities consist of two 
characters (the capability name). 


e Numerte. These indicate some numeric value 
for the terminal, such as screen size or delay 
required by a standard character. Numeric 
capabilities consist of two characters (the 
capability name), followed by a #, followed by a 
decimal number. 


e String. These indicate a sequence that is 
performs some operation on the terminal. String 


ogee 
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capabilities consist of two characters Nae 
capability name), optionally followed by a delay, 
followed by a string. 


The delay is the number of milliseconds the 
program must wait after using the sequence; 
specify no more than one decimal place. If the 
delay is proportional to the number of lines 
affected, end it with a *. 


The string is a sequence of characters. The 
following subsequences are specially interpreted. 


\E Escape Character 


° Control-z 
\n Newline 
\r Return 
\ Tab 

Backspace 
f Formfeed 


\zzz Octal value of zzz 
\072 __: in string 
\200 null (\000 doesn’t work) 


Octal numbers must be three digits long. 
Some strings are interpreted further, such as em. 


see something below. 


You can follow any capability name with an @, to 
indicate that the terminal lacks the capability. This is 
only useful in conjunction with the te capability; see 
“Similar Terminals,”’ below. 


Here is a list of standard capabilities. (P) indicates a 
string that might require padding; (P*) indicates a string 
that might require proportional padding. 


Type Pad? Description 


str P) Ends alternate character set. 

str P*) Adds new blank line. 

bool Terminal has automatic margins. 

str (P) Starts alternate character set. 

str Backspace if not control-h. 

bool Terminal can backspace with 
control-h. 

str (P) Back tab. 

bool Backspace wraps from column 0 
to last column. 

str Command character in prototype 


if terminal settable. 


bool 
str 


str 
str 


str 
str 


bool 
bool 
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Hy 


(P*) 


(P*) 


(P*) 


(P) 


Clears to end of display. 
Clears to end of line. 
Moves cursor horizontally to 
specified column. 
Clears screen. 
Moves cursor to specified row and 
column. 
Number of columns in a line. 
Carriage return if not control-m. 
Change scrolling region. 
Moves cursor. vertically to 
specified row. 
Display can be retained above. 
Delay after backspace, in 
milliseconds. 
Display can be retained below. 
Delay after carriage return, in 
milliseconds. 
Delete character. 
Delay after form feed, in 
milliseconds. 
Deletes line. 
Enters delete mode. 
Delay after newline, in 
milliseconds. 
Goes down one line. 
Delay after tab, in milliseconds. 
Ends delete mode. 
Ends insert mode; give an empty 
string if you’ve defined ic. 
Can erase overstrikes with a 
blank. 
Hardcopy terminal page eject if 
not form feed. 
Hardcopy terminal. 
Half-line down (forward 1/2 
linefeed). 
Move cursor to upper left corner 
home). 

alf-line up (reverse 1/2 linefeed). 
Hazeltine or other terminal that 
can’t print ~’s. 
Insert character. 
Name of file containing terminal 
initialization. 
Starts insert mode; give an empty 
string if you’ve defined ic. 
Insert mode distinguishes nulls on 
display. 


= 3s 
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(P*) 


(P*) 


Pad after insertion. 

Terminal initialization. 

Sent by special (usually numeric) 
function keys. If programmable, 
set with is, if, vs, or ti. 

Sent by backspace key. 

Sent by terminal down arrow key. 
Ends keypad transmit mode. 

Sent by home key. 

Sent by terminal left arrow key. 
Number of special function keys. 
Terminal capabilities that have 
keys. 

Sent by terminal right arrow key. 
Begin keypad transmit mode. 
Sent by terminal up arrow key. 
Labels on special function keys. 
Number of lines on screen or 
page. 

Last line, first column. 

Command key map; used by ex 
version 2 (Convergent uses 
version 3). 

Safe to move while in_ insert 
mode. 

Memory lock on above cursor. 
Safe to move while in standout 
and underline mode. 

Memory unlock (turn off memory 
lock). 

No correctly working carriage 
return (DM2500,H2000). 
Non-destructive space (cursor 
right). 

Begin a new line if not newline. 

A video terminal that doesn’t 
scroll! 

Terminal overstrikes. 

Pad character if not null. 

Has hardware tabs; if they need 
to be set put sequence in is or if. 
Ends stand out mode. 

Scrolls forwards. 

Number of blank chars left by so 
or se. 

Begins stand out mode. 

Scroll reverse (backwards). 

Tab if not control-i or with 
padding. 
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te 


te 
ti 
uc 


ue 
ug 
ul 

up 
us 

vb 
ve 
vs 

xb 
xn 


xr 


xs 


xt 
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str Name of terminal that has some 
of the same capabilities; te must 
be the last capability. 


str Ends programs that do cursor 
motion. 

str Initializes programs that do 
cursor motion. 

str Underscores and moves past one 
character. 

str Ends underscore mode. 

num Number of blank spaces that 
surround underscore mode. 

bool Terminal underlines 


automatically even though it 
can’t overstrike 


str Upline (cursor up). 

str Start underscore mode. 

str Visible bell (must not move 
cursor). 

str Ends open and visual modes. 

str Initializes open and visual modes. 

bool Beehive (fl=escape, f2=ctrl oy 

bool Terminal ignores newline after 
wrap (Concept). 

bool Return clears to end of line and 

oes to beginning of next line 

Delta Data). 

bool Writing on standout mode text 
produces standout mode text (HP 
264?). 

bool Destructive tabs, magic standout 


character (Teleray 1061). 


Pointers on Preparing Descriptions 


You may want to copy the description of a 
similar terminal. 


Build up a description gradually, checking 
partial descriptions with ez. 


Be aware that an unusual terminal may expose 
bugs in ez. limitations in the termcap 
convention. 


Basic Capabilities 


The 


following capabilities are common to _ most 


terminals. The co capability gives the number of 
columns per line. The li gives the number of lines on a 
video terminal. The am capability indicates that 
writing off the right edge takes the cursor to the 
beginning of the next screen. The el capability tells how 
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the terminal clears its screen. The bs indicates that the 
terminal can backspace; but if the terminal doesn’t use 
control-h, specify be instead of bs. The os capability 
indicates that printing a character at an occupied 
position doesn’t destroy the existing character. 


A couple of notes on moving off the edge. Programs 
that use this convention never move the cursor off the 
top or the left edge of the screen. On the other hand, 
they assume that moving off the bottom edge scrolls the 
display up. 

These capabilities suffice to describe hardcopy and very 
dumb terminals. For example, the Teletype Model 33 
has this description. 


t3 | 33 | tty33:co##72:0s 


This is LSI ADM3 (without the cursor addressing 
option). 
cl | adm3|3|lsi adm3:am:bs:cl=*Z:li##24:co##80 
Cursor Addresses and Other Variables 

If a string capability includes a variable value, use a % 
escape to indicate the value. By default, programs take 
these values to be zero origin (that is, the first possible 
value is 0) and that the em capability specifies two 


values: row, then column. Use the %r or %i capability 
if either assumption is incorrect. 


These are the valid % escapes. 


%d print the values as a decimal number 

%2 print the values as a two-digit decimal number 

%3 print the values as a three-digit decimal number 

%. print the value in binary (but see below) 

%-+a add ASCII value of z to value, then print in 
binary 


%> ay if the next value is greater than the ASCII value 
of z, add the ASCII value of y before using the 
value’s % escape 


%r row is the first value in this em 

%i values are 1-origin 

%%  printa % 

on in this capability, exclusive or the values with 
01400 before using the values’ % escapes 
(DM2500 

%B change the next value to binary coded decimal 
((16*(2/10)) + (z%10) where z is the value) 


before interpreting it 
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%D The next value is reverse-coded (2-2*(2%%16) 
where z is the value; Delta Data) 


A program should avoid using a em sequence that 
includes a tab, newline, control-d, or return, because the 
terminal interface may misinterpret these characters. If 
possible, use the em sequence to move to the row or 
column after the destination, then use local motion to 
get to the destination. 


Here are some examples of em definitions. To position 
the cursor of an HP2645 on row 3, column 12, you must 
send the terminal ‘\E&al2c03Y’, followed by a 6 
millisecond delay; the HP2645 description includes 
som=6\E&%r%2c%2Y:. To position the cursor of 
an ACT-IV, you send it a control-t, followed by the row 
and column in binary; the ACT-IV description includes 
:em=="T%.%.: The LSI ADM3a uses the set of 
printable ASCII characters to represent row and column 
values; its description includes :em\E=%+4+%+4:. 


Local and General Cursor Motions 
Most terminals have short strings that trigger 
commonly-used cursor motions. A non-destructive space 
(BR nd ) moves the cursor one position right. An upline 
sequence (up) moves the cursor one position up. A home 
sequence (ho) moves the cursor to the upper left hand 
corner. A lower-left (Il) goes to the other lefthand 
corner. The Il capability may be a sequence that moves 


the cursor home, then up; but otherwise programs never 
do this. 


Area Clears 

Some terminals have short sequences that clear all or 
part of a display. Clear (cl) clears the screen and homes 
the cursor; if clearing the screen does not restore the 
terminal’s normal modes, cl should include the strings 
that do. Clear to end of line (ce ) clears from the 
current cursor position to the right. Clear to end of 
display (ed ) clears from the current cursor position to 
the bottom of the display; programs always move the 
cursor to the beginning of the line before using ed. 


Insert/Delete Line 

any terminals have strings that shift text starting at 
the current cursor position. Programs always move the 
cursor to the beginning of the line before using these 
strings. Add line (al) shifts the current line and all 
below it down a position leaving the cursor on the 
newly-blanked line. Delete line (deletes the line the 
cursor is on without moving the cursor. If a terminal 
description has a al capability, you do not really need to 


ey ao 


TERMCAP (4) 


specify sb. 


If deleting a line might produce a non-blank line at the 
bottom of the screen, specify db. If scrolling backwards 
might produce a non-blank line at the top of the screen, 
specify da. 


Insert/Delete Character 


he termcap convention recognizes two kinds of terminal 


insert /delete string. 


The first convention is by far more common. 
Using insert or delete modes only affect 
characters on the current line. Inserting a single 
character shifts all characters, including all 
blanks, to the right; the character on the right 
edge of the screen is lost. No special capability 
is required to describe this kind of terminal. 


The second convention is rarer and more 
complicated. The terminal distinguishes 
between blank spaces created by output tabs 
(011) or spaces (040) from all other blanks; other 
blanks are known as nulls. Inserting a character 
eliminates the first null to the right of the 
cursor; deleting a character doubles the first 
null. If there are no nulls on the current line 
inserting a character inserts the line’s rightmost 
character at the beginning of the next line. Use 
the in capability to describe this kind of 
terminal. 


Notably among the second type are the Concept 100 and 
Perkin Elmer Owl. 


A simple experiment shows what type you have. Set the 
terminal to its ‘“‘local’? mode. Clear the screen, then 
type a short sequence of text. Move the cursor to the 
right several spaces without ustng the space or tab 
characters. Type a second short sequence of text. Move 
the cursor back to the beginning of the first text. Start 
the terminal’s insert mode and begin tapping the space 


bar. 


If you have the first kind of terminal, both 


sequences of text will move at once, at whatever 
character is at the right edge of the screen will be lost. 
If you have the second kind of terminal, at first only the 
first sequence of text will move; when the first sequence 
hits the second sequence, it will push the second onto the 
next line. 


A terminal can have either an insert mode or the ability 
to insert a single character. Specify insert mode with im 
and ei. To specify that the terminal can insert a single 
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character, specify ic and specify empty strings for im 
and ei. If you must delay or output more control text 
after inserting a single character, specify ip. 


If a terminal has both an insert mode and the ability to 
insert a single character, it is usually best not to specify 
ic. 


Some programs operate more quickly if they are allowed 
to move the cursor around randomly while in insert 
mode. For example, vt has to delete a character when 
you insert a character before a tab. If your terminal 
permits this, specify move on insert mi. Beware of 
terminals that foul up in subtle ways when you do this 
notably Datamedia’s. 


Delete mode (dm), end delete mode (ed), and delete 
character (de) work like im, ei, and ic. 


Highlighting, Underlining, and Visible Bells 
Specify the terminals most distinctive display mode with 
so se. Half intensity is usually not a good choice unless 
the terminal is normally in reverse video. 


The convention provides for underline mode and for 
single character underlining. Specify underline mode 
with us and ue. Specify a way to underline and move 
past a character with uc; if your terminal can underline 
a single character but doesn’t automatically move on, 
add a nondestructive space to the uc string. 


Some terminals can’t overstrike but still correctly 
underline text without special help from the host 
computer. If yours is one, specify ul. 


If your terminal spaces before and after entering 
standout and underline mode, specify ug. 


Programs leave standout and underline mode before 
moving the cursor or printing a newline. 


If the terminal can flash the screen without moving the 
cursor, specify vb (visual bell). 


If the terminal needs to change working modes before 
entering the open and visual modes of ez and wut, specify 
vs and ve. respectively. These can be used to change, 
e.g., from a underline to a block cursor and back. 


If the terminal needs to be in a special mode when 
running a program that addresses the cursor, specify ti 
and te. This may be important if a terminal has more 
than one page of memory. If the terminal has memory- 
relative cursor addressing but not screen relative cursor 
addressing, use ti to fix a screen-sized window into the 
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terminal. 


If a terminal can overstrike, programs assume that 
printable spaces don’t destroy anything, unless you 
specify eo. 


Keypad 

Some terminals have keypads that transmit special 
codes. If the keypad can be turned on and off, specify 
ks and ke; if you don’t, programs assume that the 
keypad is always on. Specify the codes sent by cursor 
motion keys with kl, kr, ku, kd, and kh. If there are 
function keys specify the codes they send with f1, f2, f3, 
f4, f5, 6, £7, f8, and f@. If these keys have labels other 
than the usual “fO through” “‘f9’’, specify the labels 11, 
12, 13, 14, 15, 16, 17, 18, and 19. If there are other keys 
that transmit the same code that the terminal expects 
for a function, such as clear screen, mention the affected 
capabilities in the ko capability. For example, 
‘*:-ko=cl,ll,sf,sb:”’ says that the terminal has clear, home 
down, scroll down, and scroll up keys that transmit the 
same thing as the cl, ll, sf, and sb capabilities. 


Terminal Initialization 

If a terminal must be initialized, on login for example, 
specify a short string with is or a file containing 
initialization strings with if. Other capabilities include 
is, an initialization string for the terminal, and if, the 
name of a file containing long initialization strings. If 
both are given, is is printed before if. If the terminal 
has tab stops, these strings should first clear all stops, 
then set new stops at the 9 column and every 8 columns 
thereafter. 


Similar Terminals 

a new terminal strongly resembles an_ existing 
terminal, you can write a description of the new terminal 
that only mentions the old terminal and the capabilities 
that differ. The te capability describes the old terminal; 
it must be the last capability in the description. If the 
old terminal has capabilities that the new one lacks, 
specify an @ after the capability name. 


The different entries you create with te need not 
represent terminals that are actually different. They can 
represent different uses for a single terminal, or user 
preferences as to which terminal features are desirable. 


The following example defines a describes a variant of 
the 2621 that never turns on the keypad. 


hn | 2621n):ks@:ke@:te=2621: 
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FILES 
/etc/termcap standard data base 

SEE ALSO 
ex(1), more(1), tset(1), ul(1), vi(1), curses(3), termcap(3), 
terminfo(4). 

BUGS 


Ex allows only 256 characters for string capabilities, and 
the routines in termcap(3) do not check for overflow of 
this buffer. 


The total length of a single description (excluding only 
escaped newlines) may not exceed 1024 characters. If 
you use te, the combined description may not exceed 
1024 characters. 


The vs, and ve entries are specific to the vt program. 


Not all programs support all entries. There are entries 
that are not supported by any program. 


The ma capability is obsolete and serves no function in 
our database; Berkeley includes it for the benefit of 
systems that cannot run version 3 of ut. 
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terminfo — terminal capability data base 


SYNOPSIS 


/usr/lib/terminfo/*/* 


DESCRIPTION 


Suffix 
-w 

-am 
-nam 
-n 

-na 
-np 
-rv 


Terminfo is a data base describing terminals, used, e.g.,, 
by vi(1) and curses(3X). Terminals are described in 
terminfo by giving a set of capabilities which they have, 
and by describing how operations are performed. 
Padding requirements and initialization sequences are 
included in terminfo. 


Entries in terminfo consist of a number of ‘,’ separated 
fields. White space after each ‘,’ is ignored. The first 
entry for each terminal gives the names which are known 
for the terminal, separated by ‘|’ characters. The first 
name given is the most common abbreviation for the 
terminal, the last name given should be a long name 
fully identifying the terminal, and all others are 
understood as synonyms for the terminal name. All 
names but the last should be in lower case and contain 
no blanks; the last name may well contain upper case 
and blanks for readability. 


Terminal names (except for the last, verbose entry) 
should be chosen using the following conventions. The 
particular piece of hardware making up the terminal 
should have a root name chosen, thus ‘“hp2621’’. This 
name should not contain hyphens, except that synonyms 
may be chosen that do not conflict with other names. 
Modes that the hardware can be in, or user preferences, 
should be indicated by appending a hyphen and an 
indicator of the mode. Thus, a vtl00 in 132 column 
mode would be vtl00-w. The following suffixes should 
be used where possible: 
Meaning Example 
Wide mode (more than 80 columns) vt100-w 
With auto. margins (usually default) vt100-am 
Without automatic margins vt100-nam 
Number of lines on the screen aaa—60 
No arrow keys (leave them in local) c100-na 
Number of pages of memory c100—4p 
Reverse video c100-rv 


CAPABILITIES 


The variable is the name by which the programmer (at 
the terminfo level) accesses the capability. The capname 
is the short name used in the text of the database, and is 
used by a person updating the database. The i.code is 
the two letter internal code used in the compiled 
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database, and always corresponds to the old termcap 
capability name. 


Capability names have no hard length limit, but an 
informal limit of 5 characters has been adopted to keep 
them short and to allow the tabs in the source file caps 
to line up nicely. Whenever possible, names are chosen 
to be the same as or similar to the ANSI X3.64-1979 
standard. Semantics are also intended to match those of 
the specification. 


(P) 
(G) 


indicates that padding may be specified 
indicates that the string is passed through tparm 


with parameters as given (#1). 


(*) 


indicates that padding may be based on the 


number of lines affected 


(#) 


Variable 
Booleans 
auto_left_margin, 


auto_right_margin, 
beehive_glitch, 
ceol_standout_glitch, 


eat_newline_glitch, 


erase_overstrike, 
generic_type, 


hard_copy, 
has_function_line 


has_meta_key, 
has_status_line, 
insert_null_glitch, 
memory_above, 
memory_below, 
move_insert_mode, 
move_standout_mode, 


over_strike, 
status_line_esc_ok, 
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name Code 


bw 
am 
xsb 
xhp 


xenl 


hf! 


I. 


bw 


indicates the jh parameter. 


Description 


cubl wraps from column 0 to last 
column 

Terminal has automatic margins 
Beehive (fl=escape, f2=ctrl C) 
Standout not erased by overwriting 
(hp) 
newline 
(Concept) 
Can erase overstrikes with a blank 
Generic line type (e.g.,, dialup, 
switch). 

Hardcopy terminal 

Terminal has a function key label 
line 

Has a meta key (shift, sets parity 
bit) 

Has extra “status line” 

Insert mode distinguishes nulls 
Display may be retained above the 
screen 

Display may be retained below the 
screen 

Safe to move while in insert mode 
Safe to move in standout modes 
Terminal overstrikes 

Escape can be used on the status 
line 


ignored after 80 cols 


teleray_glitch, 


tilde_glitch, 
transparent_underline, 
xon_xoff, 


Numbers: 
columns, 
init_tabs, 
line_attribute 
lines, 
lines_of_memory, 


magic_cookie_glitch, 
padding _baud_rate, 
virtual_terminal, 
width_status_line, 


Strings: 
back_tab, 
bell, 
carriage_return, 
change_scroll_region, 


clear_all_tabs, 
clear_screen, 

clr_eol, 

clr_eos, 
column_address, 
command_character, 


cursor_address, 


cursor_down, 
cursor_home, 
cursor_invisible, 
cursor_left, 
cursor_mem_address, 
eursor_normal, 


cursor_right, 
cursor_to_ll, 
cursor_up, 
cursor_visible, 
delete_character, 
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xt 


ws 


Tabs ruin, magic so char (Teleray 
1061) 

Hazeltine; can not print ~’s 
underline character overstrikes 
Terminal uses xon/xoff handshaking 


Number of columns in a line 

Tabs initially every # spaces 

Line drawing character attribute 
Number of lines on screen or page 
Lines of memory if > lines. 0 means 
varies 

Number of blank chars left by smso 
or rmso 

Lowest baud where cr/nl padding is 
needed 
Virtual 
system) 
No. columns in status line 


terminal number (UNIX 


Back tab (P) 

Audible signal (bell) (P) 

Carriage return (P*) 

change to lines #1 through #2 
(vt100) (PG) 

Clear all tab stops (P) 

Clear screen and home cursor (P*) 
Clear to end of line (P) 

Clear to end of display (P*) 

Set cursor column (PG) 


Term. settable cmd char in 
prototype 
Screen rel. cursor motion row #1 col 
#2 (PG) 


Down one line 

Home cursor (if no cup) 

Make cursor invisible 

Move cursor left one space 

Memory relative cursor addressing 
Make cursor appear normal (undo 
vs/vi) 

Non-destructive space (cursor right) 
Last line, first column (if no cup) 
Upline (cursor up) 

Make cursor very visible 

Delete character (P*) 
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delete_line, dil dl Delete line (P*) 
dis_status_line, ds] ds Disable status line 
down_half_line, hd hd Half-line down (forward 1/2 
linefeed) 
enter_alt_charset_mode, smacs as Start alternate character set (P) 
enter_blink_mode, blink mb Turn on blinking 
enter_bold_mode, bold = md Turn on bold (extra bright) mode 
enter_ca_mode, smeup ti String to begin programs that use 
cup 
expand center; |w(1.4i) lw(.4i) lw(.4i) 
Iw(1.8i). 
enter_delete_mode, smde dm Delete mode (enter) 
enter_dim_mode, dim mh Turn on half-bright mode 
enter_insert_mode, smir im Insert mode (enter); 
enter_protected_mode, prot mp Turn on protected mode 
enter_reverse_mode, rev mr Turn on reverse video mode 
enter_secure_mode, invis mk Turn on blank mode _ (chars 
invisible) 
enter_standout_mode, smso sO Begin stand out mode 
enter_underline_mode, smul us Start underscore mode 
erase_chars ech ec Erase #1 characters (PG) 
exit_alt_charset_mode, rmacs ae End alternate character set (P) 
exit_attribute_mode, sgrO = me Turn off all attributes — 
exit_ca_mode, rmcup te String to end programs that use cup 
exit_delete_mode, rmde_ ed End delete mode 
exit_insert_mode, rmir_— ei End insert mode 
exit_standout_mode, rmso_ se End stand out mode 
exit_underline_mode, rmul ue End underscore mode 
flash_screen, flash vb Visible bell (may not move cursor) 
form_feed, ff ff Hardcopy terminal page eject (P*) 
from_status_line, fs] fs Return from status line 
init_lstring, isl il Terminal initialization string 
init_2string, is2 i2 Terminal initialization string 
init_3string, is3 i3 Terminal initialization string 
init_file, if if Name of file containing is 
insert_character, ichl ic Insert character (P) 
insert_line, ill al Add new blank line (P*) 
insert_padding, ip ip Insert pad after character inserted (p*) 
key_backspace, kbs kb Sent by backspace key 
key_catab, ktbe ka Sent by clear-all-tabs key 
key_clear, kelr kC Sent by clear screen or erase key 
key_ctab, ketab = kt Sent by clear-tab key 
key_de, kdch1 kD Sent by delete character key 
key_dl, kdl kL Sent by delete line key 
key_down, keud1 kd Sent by terminal down arrow key 
key_eic, krmir kM Sent by rmir or smir in insert mode 
key_eol, kel kE Sent by clear-to-end-of-line key 
key_eos, ked kS Sent by clear-to-end-of-screen key 
key_f0, kfo ko Sent by function key f0 
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key_f1, kfl ki Sent by function key fl 

key_f10, kfl10 ka Sent by function key fl0 

key_f2, kf2 k2 Sent by function key [2 

key_f3, kf3 k3 Sent by function key f3 

key_f4, kf4 k4 Sent by function key f4 

key_f5, kf5 k5 Sent by function key f5 

key_f6, kf6 k6 Sent by function key [6 

key_f7, kf7 k7 Sent by function key f7 

key_f8, kfg k8& Sent by function key f8 

key_f9, kf9 kg Sent by function key [9 

key_home, khome kh Sent by home key 

key_ic, kichl kl Sent by ins char/enter ins mode key 

key_il, kill kA Sent by insert line 

key_left, keubl_ kl Sent by terminal left arrow key 

key_ll, kil kH Sent by home-down key 

key_npage, knp kN Sent by next-page key 

key_ppage, kpp kP Sent by previous-page key 

key_right, keufl kr Sent by terminal right arrow key 

key_sf, kind kF Sent by scroll-forward/down key 

key_sr, kri kR Sent by scroll-backward/up key 

key_stab, khts kT Sent by set-tab key 

key_up, keuul ku Sent by terminal up arrow key 

keypad_local, rmkx ke Out of "keypad transmit” mode 

keypad_xmit, smkx ks Put terminal in “keypad transmit” 
mode 

lab_fo, 1f0 10 Labels on function key f0 if not [0 

lab_f1, Ifl 11 Labels on function key f1 if not f1 

lab_f10, 1f10 la Labels on function key [10 if not [10 

lab_f2, 1f2 12 Labels on function key f2 if not f2 

lab_f3, If3 13 Labels on function key f3 if not [3 

lab_f4, 1f4 14 Labels on function key [4 if not f4 

lab_f5, 1fS 15 Labels on function key [5 if not f5 

lab_f6, 1f6 16 Labels on function key [6 if not f6 

lab_f7, If7 17 Labels on function key [7 if not [7 

lab_f8, fg 18 Labels on function key [8 if not [8 

lab_f9, If9 19 Labels on function key [9 if not f9 

Id_upleft Idul TL Upper left corner box character 

Id_upright Idur TR Upper right corner box character 

Id_botleft Idul BL Bottom left corner box character 

Id_botright Idbl BR Bottom right corner box character 

Id_vertleft Idvl VL Left-hand side box character 

Id_vertright Idvr VR Right-hand side box character 

Id_hortop Idht TH Top side box character 

ld_horbot Idhb BH Bottom horizontal box character 

Id_upleft Idul TL Upper left corner box character 

Id_upleft \dul TL Upper left corner box character 

Id_upleft Idul TL Upper left corner box character 

meta_on, smm mm __ Turnon "meta mode” (8th bit) 

meta_off, rmm = mo Turn off “meta mode” 


newline, 

pad_char, 
parm_dch, 
parm_delete_line, 
parm_down_cursor, 
parm_ich, 
parm_index, 
parm_insert_line, 
parm_left_cursor, 
parm_right_cursor, 
parm_rindex, 
parm_up_cursor, 
pkey_key, 
pkey_local, 
pkey_xmit, 
print_screen, 
prtr_off, 

prtr_on, 
repeat_char, 
reset_Istring, 


reset_2string, 
reset_3string, 


reset_file, 
restore_cursor, 
row_address, 
save_cursor, 
scroll_forward, 
scroll_reverse, 
set_attributes, 
set_tab, 
set_window, 


tab, 
to_status_line, 
underline_char, 
up_half_line, 
init_prog, 
key_al, 
key_a3, 
key_b2, 
key_cl, 
key_c3, 
prtr_non, 
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nel 
pad 
dch 
dl 
cud 
ich 
indn 
il 
cub 
cuf 
rin 
cuu 
pfkey 
pfloc 
pfx 
mcO 
mc4 
mcd 
rep 
rsl 


rs2 
rs3 


rf 

re 
vpa 
sc 
ind 
ri 
sgr 
hts 
wind 


ht 

tsl 

uc 

hu 
iprog 
kal 
ka3 
kb2 
kel 
ke3 
mcop 


Newline (behaves like cr followed by If) 
Pad character (rather than null) 
Delete #1 chars (PG*) 

Delete #1 lines (PG*) 

Move cursor down #1 lines (PG*) 
Insert. #1 blank chars (PG*) 

Scroll forward #1 lines (PG) 

Add #1 new blank lines (PG*) 

Move cursor left #1 spaces (PG) 

Move cursor right #1 spaces (PG*) 
Scroll backward #1 lines (PG) 

Move cursor up #1 lines (PG*) 

Prog funct key #1 to type string #2 
Prog funct key #1 to execute string #2 
Prog funct key #1 to xmit string #2 
Print contents of the screen 

Turn off the printer 

Turn on the printer 

Repeat char #1 #2 times. (PG*) 


Reset terminal completely to sane 
modes. 
Reset terminal completely to sane 
modes. 
Reset terminal completely to sane 
modes. 


Name of file containing reset string 
Restore cursor to position of last sc 
Vertical position absolute set row) (PG) 
Save cursor position (P) 

Scroll text up (P) 

Scroll text down (P) 

Define the video attributes (PG9) 

Set a tab in all rows, current column 
Current window is lines #1-#2 

cols #3-#4 

Tab to next 8 space hardware tab stop 
Go to status line, column #1 
Underscore one char and move past it 
Half-line up {reverse 1/2 linefeed) 
Path name of program for init 

Upper left of keypad 

Upper right of keypad 

Center of keypad 

Lower left of keypad 

Lower right of keypad 

Turn on the printer for #1 bytes 
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A Sample Entry 
The following entry, which describes the Concept— 100, is 
among the more complex entries in the terminfo file as of 
this writing. 


concept100 | c100| concept { c104 | c100-4p | concept 100, 

am, bel=*G, blank=\EH, blink=\EC, clear=“L$<2*>, cnorm=\Ew, 
cols#80, cr-="M$<9>, cubl=‘H, cudl=“J, cufl=\E=, 

cup=\Ea%p1%’ '%+%c% p2%’ '%+%e, 

cuul=\E;, cvvis=\EW, db, dchl=\E*A$<16*>, dim=\EE, dii=\E*B$<3*>, 
ed==\E’C$<16*>, el=\E°U$<16>, eo, flash=\Ek$<20>\EK, ht=\t$<8>, 
il1=\E’R$<3*>, in, ind=*J, .ind=*J$<9>, ip—$<16*>, 
is2=\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\Eo&\200\Eo\47\E, 

kbs=“h, kcubl=\E>, kcudl1=\E<, keufl=\E=, kcuul=\E;, 

kfl=\ES, kf2=\E6, kf3=\E7, khome=\E?, 

lines#24, mir, pb#9600, prot=\EI, rep=\Er%p1%c% p2%’ "%+%c$<.2*>, 
rev=\ED, rmcup=\Ev $<6>\Ep\r\n, rmir=\E\200, rmkx=\Ex, 
rmso=\Ed\Ee, rmul=\Eg, rmul=\Eg, sgrO=\EN\200, 

smcup=\EU\Ev 8p\Ep\r, smir=\E*P, smkx=\EX, smso=\EE\ED, 
smul=\EG, tabs, ul, vt#8, xenl, 


Entries may continue onto multiple lines by placing 
white space at the beginning of each line except the first. 
Comments may be included on lines beginning with 
“de” Capabilities in terminfo are of three types: 
Boolean capabilities which indicate that the terminal has 
some particular feature, numeric capabilities giving the 
size of the terminal or the size of particular delays, and 
string capabilities, which give a sequence which can be 
used to perform particular terminal operations. 


Types of Capabilities 

All capabilities have names. For instance, the fact that 
the Concept has automatic margins (i.e., an automatic 
return and linefeed when the end of a line is reached) is 
indicated by the capability am. Hence the description of 
the Concept includes am. Numeric capabilities are 
followed by the character ‘#’ and then the value. Thus 
cols, which indicates the number of columns the 
terminal has, gives the value ‘80’ for the Concept. 


Finally, string valued capabilities, such as el (clear to 
end of line sequence) are given by the two-character 


¢ ? 


code, an ‘=’, and then a string ending at the next 
following ‘,’. A delay in milliseconds may appear 
anywhere in such a capability, enclosed in $<..> 
brackets, as in el=\EK$<3>, and padding characters 
are supplied by tputs to provide this delay. The delay 
can be either a number, e.g., ‘20’, or a number followed 
by an ‘*’, ie., ‘3%’. A ‘*’ indicates that the padding 
required is proportional to the number of lines affected 
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by the operation, and the amount given is the per- 
affected-unit padding required. (In the case of insert 
character, the factor is still the number of lines affected. 
This is always one unless the terminal has xen} and the 
software uses it.) When a ‘*’ is specified, it is sometimes 
useful to give a delay of the form ‘3.5’ to specify a delay 
per unit to tenths of milliseconds. (Only one decimal 
place is allowed.) 


A number of escape sequences are provided in the string 
valued capabilities for easy encoding of characters there. 
Both \E and \e map to an ESCAPE character, “x maps 
to a control-x for any appropriate x, and the sequences 
\n \I \r \t \b Ns \s give a newline, linefeed, return, 
tab, backspace, formfeed, and space. Other escapes 
include \* for *, \\ for \, \, for comma, \: for :, and \0 
for null. (\0 will produce \200, which does not terminate 
a string but behaves as a null character on most 
terminals.) Finally, characters may be given as three 
octal digits after a \. 


Sometimes individual capabilities must be commented 
out. To do this, put a period before the capability 
name. For example, see the second ind in the example 
above. 


Preparing Descriptions 
We now outline how to prepare descriptions of terminals. 
The most effective way to prepare a terminal description 
is by imitating the description of a similar terminal in 
terminfo and to build up a description gradually, using 
partial descriptions with vt to check that they are 
correct. Be aware that a very unusual terminal may 
expose deficiencies in the ability of the termznfo file to 
describe it or bugs in vt. To easily test a new terminal 
description you can set the environment variable 
TERMINFO to a pathname of a directory containing the 
compiled description you are working on and programs 
will look there rather than in /usr/lib/terminfo. To get 
the padding for insert line right (if the terminal 
manufacturer did not document it) a severe test is to 
edit /etc/passwd at 9600 baud, delete 16 or so lines from 
the middie of the screen, then hit the ‘u’ key several 
times quickly. If the terminal messes up, more padding 
is usually needed. A similar test can be used for insert 
character. 
Basic Capabilities 

The number of columns on each line for the terminal is 
given by the cols numeric capability. If the terminal is 
a CRT, then the number of lines on the screen is given 


5/86 xR 


5/86 


TERMINFO(4) 


by the lines capability. If the terminal wraps around to 
the beginning of the next line when it reaches the right 
margin, then it should have the am capability. If the 
terminal can clear its screen, leaving the cursor in the 
home position, then this is given by the clear string 
capability. If the terminal overstrikes (rather than 
clearing a position when a character is struck over) then 
it should have the os capability. If the terminal is a 
printing terminal, with no soft copy unit, give it both he 
and os. (os applies to storage scope terminals, such as 
TEKTRONIX 4010 series, as well as hard copy and APL 
terminals.) If there is a code to move the cursor to the 
left edge of the current row, give this as er. (Normally 
this will be carriage return, control M.) If there is a code 
to produce an audible signal (bell, beep, etc) give this as 
bel. 


If there is a code to move the cursor one position to the 
left (such as backspace) that capability should be given 
as cubl. Similarly, codes to move to the right, up, and 
down should be given as cufl, cuul, and cudl. These 
local cursor motions should not alter the text they pass 
over, for example, you would not normally use ‘cuf1= ’ 
because the space would erase the character moved over. 


A very important point here is that the local cursor 
motions encoded in terminfo are undefined at the left 
and top edges of a CRT terminal. Programs should 
never attempt to backspace around the left edge, unless 
bw is given, and never attempt to go up locally off the 
top. In order to scroll text up, a program will go to the 
bottom left corner of the screen and send the ind (index) 
string. 

To scroll text down, a program goes to the top left 
corner of the screen and sends the ri (reverse index) 
string. The strings ind and ri are undefined when not 
on their respective corners of the screen. 


Parameterized versions of the scrolling sequences are 
indn and rin which have the same semantics as ind and 
ri except that they take one parameter, and scroll that 
many lines. They are also undefined except at the 
appropriate edge of the screen. 


The am capability tells whether the cursor sticks at the 
right edge of the screen when text is output, but this 
does not necessarily apply to a cufl from the last 
column. The only local motion which is defined from 
the left edge is if bw is given, then a cub] from the left 
edge will move to the right edge of the previous row. If 
bw is not given, the effect is undefined. This is useful 
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for drawing a box around the edge of the screen, for 
example. If the terminal has switch selectable automatic 
margins, the terminfo file usually assumes that this is on; 
i.e., am. If the terminal has a command which moves to 
the first column of the next line, that command can be 
given as nel (newline). It does not matter if the 
command clears the remainder of the current line, so if 
the terminal has no cr and If it may still be possible to 
craft a working nel out of one or both of them. 


These capabilities suffice to describe hardcopy and 
glass-tty terminals. Thus the model 33 teletype is 
described as 


33 | tty33 | tty | model 33 teletype, 

bel=°G, cols#72, cr=*M, cudl=“J, he, ind=“J, os, 

while the Lear Siegler ADM-3 is described as 

adm3 | 3 | Isi adm3, 

am, bel=°G, clear=“*Z, cols#80, cr=*M, cubl=‘H, cud1=‘J, 
ind=“*J, lines#24, 


Parameterized Strings 
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Cursor addressing and other strings requiring parameters 
in the terminal are described by a parameterized string 
capability, with printf(3S) like escapes %x in it. For 
example, to address the cursor, the cup capability is 
given, using two parameters: the row and column to 
address to. (Rows and columns are numbered from zero 
and refer to the physical screen visible to the user, not to 
any unseen memory.) If the terminal has memory 
relative cursor addressing, that can be indicated by 
mrcup. 


The parameter mechanism uses a stack and special % 
codes to manipulate it. Typically a sequence will push 
one of the parameters onto the stack and then print it in 
some format. Often more complex operations are 
necessary. 


The % encodings have the following meanings: 


%% outputs ‘%’ 

%d print pop() as in printf 

%2d print pop() like %2d 

%3d print pop() like %3d 

%02d 

%03d as in printf 

%e print pop() gives %c 

%s print pop() gives %s 

%pl1-9 push ith parm 

%Pla—z set variable [a—z] to pop() 
-10- 
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%gla-z| get variable [a—z] and push it 
%'e’ char constant c 
% {nn} integer constant nn 


%+ %- %* %/ Yom 
arithmetic (%m is mod): push(pop() 


op pop()) 
%& Go| Fo* bit operations: push(pop() op pop()) 
%= > B< logical operations: push(pop() 
op pop()) 
%! % unary operations push(op pop()) 
%i add 1 to first two parms (for ANSI 
terminals) 


%? expr %t thenpart %e elsepart %; 
if-then-else, %e elsepart is optional. 
else-if’s are possible ala Algol 68: 
%? c %t by %e Cy Yt b %e Ce 
%t by %e C4 %rt_b, %e %, 


c; are conditions, b, are bodies. 


Binary operations are in postfix form with the operands 
in the usual order. That is, to get x-5 one would use 
"%ex% {5} %-". 

Consider the HP2645, which, to get to row 3 and column 
12, needs to be sent \E&al2cO3Y padded for 6 
milliseconds. Note that the order of the rows and 
columns is inverted here, and that the row and column 
are printed as two digits. Thus its cup capability is 
cup=6\E& %p2%2dce%p1%2dY. 


The Microterm ACT-IV needs the current row and 
column sent preceded by a “T, with the row and column 
simply encoded in binary, cup=“T%p1%c%p2%c. 
Terminals which use %c need to be able to backspace 
the cursor (cub1), and to move the cursor up one line on 
the screen (cuui). This is necessary because it is not 
always safe to transmit \n “D and \r, as the system 
may change or discard them. (The library routines 
dealing with terminfo set tty modes so that tabs are 
never expanded, so \t is safe to send. This turns out to 
be essential for the Ann Arbor 4080.) 


A final example is the LSI ADM-3a, which uses row and 
column offset by a blank character, thus 
cup=\E=%p1%’ = %+%c%p2%’ °%+%c. After 
sending ‘\E=’, this pushes the first parameter, pushes 
the ASCII value for a space (32), adds them (pushing the 
sum on the stack in place of the two previous values) 
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and outputs that value as a character. Then the same is 
done for the second parameter. More complex arithmetic 
is possible using the stack. 


If the terminal has row or column absolute cursor 
addressing, these can be given as single parameter 
capabilities hpa (horizontal position absolute) and vpa 
(vertical position absolute). Sometimes these are shorter 
than the more general two parameter sequence (as with 
the hp2645) and can be used in preference to cup . If 
there are parameterized local motions (e.g., move n 
spaces to the right) these can be given as cud, cub, cuf, 
and cuu with a single parameter indicating how many 
spaces to move. These are primarily useful if the 
terminal does not have cup, such as the TEKTRONIX 
4025. 


Cursor Motions 


If the terminal has a fast way to home the cursor (to 
very upper left corner of screen) then this can be given 
as home; similarly a fast way of getting to the lower 
left-hand corner can be given as I; this may involve 
going up with cuul from the home position, but a 
program should never do this itself (unless Il does) 
because it can make no assumption about the effect of 
moving up from the home position. Note that the home 
position is the same as addressing to (0,0): to the top left 
corner of the screen, not of memory. (Thus, the \EH 
sequence on HP terminals cannot be used for home.) 


Area Clears 


If the terminal can clear from the current position to the 
end of the line, leaving the cursor where it is, this should 
be given as el. If the terminal can clear from the current 
position to the end of the display, then this should be 
given as ed. Ed is only defined from the first column of 
a line. (Thus, it can be simulated by a request to delete 
a large number of lines, if a true ed is not available.) 


Insert/delete line 
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If the terminal can open a new blank line before the line 
where the cursor is, this should be given as il1; this is 
done only from the first position of a line. The cursor 
must then appear on the newly blank line. If the 
terminal can delete the line which the cursor is on, then 
this should be given as dl1; this is done only from the 
first position on the line to be deleted. Versions of ill 
and dll which take a single parameter and insert or 
delete that many lines can be given as i] and dl. If the 
terminal has a settable scrolling region (like the vt100) 
the command to set this can be described with the esr 
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capability, which takes two parameters: the top and 
bottom lines of the scrolling region. The cursor position 
is, alas, undefined after using this command. It is 
possible to get the effect of insert or delete line using this 
command — the se and re (save and restore cursor) 
commands are also useful. Inserting lines at the top or 
bottom of the screen can also be done using ri or ind on 
many terminals without a true insert/delete line, and is 
often faster even on terminals with those features. 


If the terminal has the ability to define a window as part 
of memory, which all commands affect, it should be 
given as the parameterized string wind. The four 
parameters are the starting and ending lines in memory 
and the starting and ending columns in memory, in that 
order. 


If the terminal can retain display memory above, then 
the da capability should be given; if display memory can 
be retained below, then db should be given. These 
indicate that deleting a line or scrolling may bring non- 
blank lines up from below or that scrolling back with ri 
may bring down non-blank lines. 


Insert/Delete Character 
There are two basic kinds of intelligent terminals with 
respect to insert/delete character which can be described 
using terminfo. The most common _ insert/delete 
character operations affect only the characters on the 
current line and shift characters off the end of the line 
rigidly. Other terminals, such as the Concept 100 and 
the Perkin Elmer Owl, make a distinction between typed 
and untyped blanks on the screen, shifting upon an 
insert or delete only to an untyped blank on the screen 
which is either eliminated, or expanded to two untyped 
blanks. You can determine the kind of terminal you 
have by clearing the screen and then typing text 
separated by cursor motions. Type abc def using local 
cursor motions (not spaces) between the abc and the def. 
Then position the cursor before the abe and put the 
terminal in insert mode. If typing characters causes the 
rest of the line to shift rigidly and characters to fall off 
the end, then your terminal does not distinguish between 
blanks and untyped positions. If the abc shifts over to 
the def which then move together around the end of the 
current line and onto the next as you insert, you have 
the second type of terminal, and should give the 
capability in, which stands for insert null. While these 
are two logically separate attributes (one line vs. 
multiline insert mode, and special treatment of untyped 
spaces) we have seen no terminals whose insert mode 
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cannot be described with the single attribute. 


Terminfo can describe both terminals which have an 
insert mode, and terminals which send a simple sequence 
to open a blank position on the current line. Give as 
smir the sequence to get into insert mode. Give as rmir 
the sequence to leave insert mode. Now give as ichl 
any sequence needed to be sent just before sending the 
character to be inserted. Most terminals with a true 
insert mode will not give ich1; terminals which send a 
sequence to open a screen position should give it here. 
(If your terminal has both, insert mode is usually 
preferable to ich1. Do not give both unless the terminal 
actually requires both to be used in combination.) If post 
insert padding is needed, give this as a number of 
milliseconds in ip (a string option). Any other sequence 
which may need to be sent after an insert of a single 
character may also be given in ip. If your terminal 
needs both to be placed into an ‘insert mode’ and a 
special code to precede each inserted character, then 
both smir/rmir and ich1 can be given, and both will be 
used. The ich capability, with one parameter, n, will 
repeat the effects of ich1 n times. 


It is occasionally necessary to move around while in 
insert mode to delete characters on the same line (e.g., if 
there is a tab after the insertion position). If your 
terminal allows motion while in insert mode you can give 
the capability mir to speed up inserting in this case. 
Omitting mir will affect only speed. Some terminals 
(notably Datamedia’s) must not have mir because of the 
way their insert mode works. 


Finally, you can specify dchl to delete a single 
character, dch with one parameter, n, to delete n 
characters, and delete mode by giving smde and rmdc 
to enter and exit delete mode (any mode the terminal 
needs to be placed in for dch1 to work). 


A command to erase n characters (equivalent to 
outputting n blanks without moving the cursor) can be 
given as ech with one parameter. 


Highlighting, Underlining, and Visible Bells 
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f your terminal has one or more kinds of display 
attributes, these can be represented in a number of 
different ways. You should choose one display form as 
standout mode, representing a good, high contrast, easy- 
on-the-eyes, format for highlighting error messages and 
other attention getters. (If you have a choice, reverse 
video plus half-bright is good, or reverse video alone.) 
The sequences to enter and exit standout mode are given 
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as smso and rmso, respectively. If the code to change 
into or out of standout mode leaves one or even two 
blank spaces on the screen, as the TVI 912 and Teleray 
1061 do, then xme should be given to tell how many 
spaces are left. 


Codes to begin underlining and end underlining can be 
given as smul and rmul respectively. If the terminal 
has a code to underline the current character and move 
the cursor one space to the right, such as the Microterm 
Mime, this can be given as uc. 


Other capabilities to enter various highlighting modes 
include blink (blinking) bold eld or extra bright) dim 
(dim or half-bright) invis (blanking or invisible text) 
prot sass rev (reverse video) sgrO (turn off all 
attribute modes) smacs (enter alternate character set 
mode) and rmacs (exit alternate character set mode). 
Turning on any of these modes singly may or may not 
turn off other modes. 


If there is a sequence to set arbitrary combinations of 
modes, this should be given as sgr (set attributes), 
taking 7 parameters. Each parameter is either 0 or 1, as 
the corresponding attribute is on or off. The 7 
parameters are, in order: standout, underline, reverse, 
blink, dim, bold, alternate character set. Not all modes 
need be supported by sgr, only those for which 
corresponding separate attribute commands exist. 


Terminals with the ‘“‘magic cookie” glitch (xmc) deposit 
special “cookies” when they receive mode-setting 
sequences, which affect the display algorithm rather than 
having extra bits for each character. Some terminals, 
such as the HP 2621, automatically leave standout mode 
when they move to a new line or the cursor is addressed. 
Programs using standout mode should exit standout 
mode before moving the cursor or sending a newline, 
unless the msgr capability, asserting that it is safe to 
move in standout mode, is present. 


If the terminal has a way of flashing the screen to 
indicate an errér quietly (a bell replacement) then this 
can be given as flash; it must not move the cursor. 


If the cursor needs to be made more visible than normal 
when it is not on the bottom line (to make, for example, 
a non-blinking underline into an easier to find block or 
blinking underline) give this sequence as evvis. If there 
is a way to make the cursor completely invisible, give 
that as civis. The capability cnorm should be given 
which undoes the effects of both of these modes. 
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If the terminal needs to be in a special mode when 
running a program that uses these capabilities, the codes 
to enter and exit this mode can be given as smcup and 
rmcup. This arises, for example, from terminals like 
the Concept with more than one page of memory. If the 
terminal has only memory relative cursor addressing and 
not screen relative cursor addressing, a one screen-sized 
window must be fixed into the terminal for cursor 
addressing to work properly. This is also used for the 
TEKTRONIX 4025, where smcup sets the command 
character to be the one used by terminfo. 


If your terminal correctly generates underlined characters 
(with no special codes needed) even though it does not 
overstrike, then you should give the capability ul. If 
overstrikes are erasable with a blank, then this should be 
indicated by giving eo. 


Keypad 

If the terminal has a keypad that transmits codes when 
the keys are pressed, this information can be given. Note 
that it is not possible to handle terminals where the 
keypad only works in local (this applies, for example, to 
the unshifted HP 2621 keys). If the keypad can be set to 
transmit or not transmit, give these codes as smkx and 
rmkx. Otherwise the keypad is assumed to always 
transmit. The codes sent by the left arrow, right arrow, 
up arrow, down arrow, and home keys can be given as 
keubl, keufl, kcuul, kcud1, and khome respectively. 
If there are function keys such as f0, fl, ..., f10, the 
codes they send can be given as kf0, kf1, ..., kf10. If 
these keys have labels other than the default f0 through 
f10, the labels can be given as IfO, If1, ..., 1f10. The 
codes transmitted by certain other special keys can be 
given: kll (home down), kbs (backspace), ktbe (clear all 
tabs), ketab (clear the tab stop in this column), kelr 
(clear screen or erase key}, kdch1 (delete character), 
kdl1 yaelets line), krmir (exit insert mode), kel (clear to 
end of line), ked (clear to end of screen), kich1 (insert 
character or enter insert mode), kill (insert line), knp 
pnext page), kpp (previous page), kind (scroll 
orward/down), kri (scroll backward/up), khts (set a 
tab stop in this column). In addition, if the keypad has 
a 3 by 3 array of keys including the four arrow keys, the 
other five keys can be given as kal, ka3, kb2, kel, and 
kce3. These keys are useful when the effects of a 3 by 3 
directional pad are needed. 


Tabs and Initialization 
If the terminal has hardware tabs, the command to 
advance to the next tab stop can be given as ht (usually 
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control I). A “‘backtab’’ command which moves leftward 
to the next tab stop can be given as cbt. By convention, 
if the teletype modes indicate that tabs are being 
expanded by the computer rather than being sent to the 
terminal, programs should not use ht or cbt even if they 
are present, since the user may not have the tab stops 
properly set. If the terminal has hardware tabs which 
are initially set every n spaces when the terminal is 
powered up, the numeric parameter it is given, showing 
the number of spaces the tabs are set to. This is 
normally used by the tset command to determine 
whether to set the mode for hardware tab expansion, and 
whether to set the tab stops. If the terminal has tab 
stops that can be saved in nonvolatile memory, the 
terminfo description can assume that they are properly 
set. 


Other capabilities include is1, is2, and is3, initialization 
strings for the terminal, iprog, the path name of a 
program to be run to initialize the terminal, and if, the 
name of a file containing long initialization strings. 
These strings are expected to set the terminal into modes 
consistent with the rest of the terminfo description. 
They are normally sent to the terminal, by the féset 
program, each time the user logs in. They will be 
printed in the following order: is1; is2; setting tabs using 
tbe and hts; if; running the program iprog; and finally 
is3. Most initialization is done with is2. Special 
terminal modes can be set up without duplicating strings 
by putting the common sequences in is2 and special 
cases in isl and is3. A pair of sequences that does a 
harder reset from a totally unknown state can be 
analogously given as rsl1, rs2, rf, and rs3, analogous to 
is2 and if. These strings are output by the reset 
program, which is used when the terminal gets into a 
wedged state. Commands are normally placed in rs2 
and rf only if they produce annoying effects on the 
screen and are not necessary when logging in. For 
example, the command to set the vt100 into 80-column 
mode would normally be part of is2, but it causes an 
annoying glitch of the screen and is not normally needed 
since the terminal is usually already in 80 column mode. 


If there are commands to set and clear tab stops, they 
can be given as tbe (clear all tab stops) and hts (set a 
tab stop in the current column of every row). If a more 
complex sequence is needed to set the tabs than can be 
described by this, the sequence can be placed in is2 or if. 


Certain capabilities control padding in the teletype 
driver. These are primarily needed by hard copy 
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terminals, and are used by the tset program to set 
teletype modes appropriately. Delays embedded in the 
capabilities er, ind, cubl, ff, and tab will cause the 
appropriate delay bits to be set in the teletype driver. If 
pb (padding baud ea is given, these values can be 
ignored at baud rates below the value of pb. 


Miscellaneous 


If the terminal requires other than a null (zero) character 
as a pad, then this can be given as pad. Only the first 
character of the pad string is used. 


If the terminal has an extra ‘“‘status line” that is not 
normally used by software, this fact can be indicated. If 
the status line is viewed as an extra line below the 
bottom line, into which one can cursor address normally 
(such as the Heathkit h19’s 25th line, or the 24th line of 
a vt100 which is set to a 23-line scrolling region), the 
capability hs should be given. Special strings to go to 
the beginning of the status line and to return from the 
status line can be given as tsl and fsl. (fsl must leave 
the cursor position in the same place it was before tsl. If 
necessary, the se and re strings can be included in tsl 
and fsl to get this effect.) The parameter tsl takes one 
parameter, which is the column number of the status line 
the cursor is to be moved to. If escape sequences and 
other special commands, such as tab, work while in the 
status line, the flag eslok can be given. A string which 
turns off the status line (or otherwise erases its contents) 
should be given as dsl. If the terminal has commands to 
save and restore the position of the cursor, give them as 
se and re. The status line is normally assumed to be the 
same width as the rest of the screen, e.g., cols. If the 
status line is a different width peeibly because the 
terminal does not allow an entire line to be loaded) the 
width, in columns, can be indicated with the numeric 
parameter wsl. 


If the terminal can move up or down half a line, this can 
be indicated with hu (half-line up) and hd (half-line 
down). This is primarily useful for superscripts and 
subscripts on hardcopy terminals. If a hardcopy 
terminal can eject to the next page (form feed), give this 
as ff (usually control L). 


If there is a command to repeat a given character a 
given number of times (to save time transmitting a large 
number of identical characters) this can be indicated 
with the parameterized string rep. The first parameter 
is the character to be repeated and the second is the 
number of times to repeat it. Thus, tparm(repeat_char, 
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*x’, 10) is the same as ‘xxxxXXxXXxxx’. 


If the terminal has a settable command character, such 
as the TEKTRONIX 4025, this can be indicated with 
emdch. A _ prototype command character is chosen 
which is used in all capabilities. This character is given 
in the emdch capability to identify it. The following 
convention is supported on CTIX: The environment is to 
be searched for a CC variable, and if found, all 
occurrences of the prototype character are replaced with 
the character in the environment variable. 


Terminal descriptions that do not represent a specific 
kind of known terminal, such as switch, dialup, patch, 
and network, should include the gn (generic) capability 
so that programs can complain that they do not know 
how to talk to the terminal. (This capability does not 
apply to vtrtual terminal descriptions for which the 
escape sequences are known.) 


If the terminal uses xon/xoff handshaking for flow 
control, give xon. Padding information should still be 
included so that routines can make better decisions 
about costs, but actual pad characters will not be 
transmitted. 


If the terminal has a ‘“‘meta key” which acts as a shift 
key, setting the 8th bit of any character transmitted, 
this fact can be indicated with km. Otherwise, software 
will assume that the 8th bit is parity and it will usually 
be cleared. If strings exist to turn this “‘meta mode”’ on 
and off, they can be given as smm and rmm. 


If the terminal has more lines of memory than will fit on 
the screen at once, the number of lines of memory can be 
indicated with Im. A value of lm#0 indicates that the 
number of lines is not fixed, but that there is still more 
memory than fits on the screen. 


If the terminal is one of those supported by the UNIX 
virtual terminal protocol, the terminal number can be 
given as vt. 


Media copy strings which control an auxiliary printer 
connected to the terminal can be given as mcO: print the 
contents of the screen, mc4: turn off the printer, and 
mce5: turn on the printer. When the printer is on, all 
text sent to the terminal will be sent to the printer. It is 
undefined whether the text is also displayed on the 
terminal screen when the printer is on. A variation 
mc5p takes one parameter, and leaves the printer on for 
as many characters as the value of the parameter, then 
turns the printer off. The parameter should not exceed 
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255. All text, including me4, is transparently passed to 
the printer while an mc5p is in effect. 


Strings to program function keys can be given as pfkey, 
pfloc, and pfx. Each of these strings takes two 
parameters: the function key number to program (from 0 
to 10) and the string to program it with. Function key 
numbers out of this range may program undefined keys 
in a terminal dependent manner. The difference between 
the capabilities is that pfkey causes pressing the given 
key to be the same as the user typing the given string; 
pfloc causes the string to be executed by the terminal in 
local; and pfx causes the string to be transmitted to the 
computer. 


If the terminal is capable of drawing solid line boxes, 

possibly by changing to a special character set, this may 

be specified. Eight single-line drawing characters may be 

given. The eight eight characters that may be specified 

represent the top left corner, top right corner, bottom 

left corner, bottom right corner left side, right side, top 

side, and bottom side of a solid line box. The four 

corner are specified with Idul, Idur, Idbl, and Idbr. 

The four sides may be specified with Idvl, ldvr, Idht, 

and Idhb. If the terminal must be in a special mode to 

draw the line characters, specify the necessary sequences 

to enter and exit the mode as one of the six highlight 

modes (alternate character set is usually a good choice); 

then give the mode number as a numeric value to Idatt. 

The correspondence of highlight modes and numeric 

values is as follows: 

1 underline 

reverse 

blink 

dim 

bold 

alternate character set 

standout. 

Glitches and Braindamage 
Hazeltine terminals, which do not allow 
be displayed should indicate hz. 
Terminals which ignore a linefeed immediately after an 
am wrap, such as the Concept and vtl00, should 
indicate xenl. 
If el is required to get rid of standout (instead of merely 
writing normal text on top of it), xhp should be given. 
Teleray terminals, where tabs turn all characters moved 
over to blanks, should indicate xt (destructive tabs). 
This glitch is also taken to mean that it is not possible 
to position the cursor on top of a ‘“‘magic cookie’’, that 


NOD OR W DO 


‘~? characters to 
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to erase standout mode it is instead necessary to use 
delete and insert line. 

The Beehive Superbee, which is unable to correctly 
transmit the escape or control C characters, has xsb, 
indicating that the fl key is used for escape and f2 for 
control C. (Only certain Superbees have this problem, 
depending on the ROM.) 

Other specific terminal problems may be corrected by 
adding more capabilities of the form xz. 


Similar Terminals 


FILES 


If there are two very similar terminals, one can be 
defined as being just like the other with certain 
exceptions. The string capability use can be given with 
the name of the similar terminal. The capabilities given 
before use override those in the terminal type invoked 
by use. A capability can be cancelled by placing xx@ to 
the left of the capability definition, where xx is the 
capability. For example, the entry 
2621-nl, smkx@, rmkx@, use=2621, 

defines a 2621-nl that does not have the smkx or rmkx 
capabilities, and hence does not turn on the function key 
labels when in visual mode. This is useful for different 
modes for a terminal, or for different user preferences. 


/usr/lib/terminfo/?/* files containing terminal 
descriptions 


SEE ALSO 


tic(1M), curses(3X), printf(3S), termcap(4), term(5). 
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NAME 
ttytype — list of terminal types by terminal number 


DESCRIPTION 
Ttytype is a text file that contains, for each terminal 
configured, the terminal type as described in termeap(4). 
It is used by adie when that program sets the TERM 
environment variable. 


A line in ttytype consists of a terminal name (one of the 
abbreviations from the first field of the termcap entry), 
followed by a space, followed by the special file name of 
the terminal without the initial /dev/. 


EXAMPLES 
pt tty000 
FILES 
/etc/ttytype 
SEE ALSO 
tset(1), termcap(4). 


NAME 


TZ(4) 


TZ — time zone file 


DESCRIPTION 


FILES 


The /etc/TZ file describes the time zone for the locality 
of the CTIX system. The file contains a single entry of 
the form: 


zSTn(zDT] 


where zST is the standard three-letter abbreviation for 
the standard time zone; n is the difference in hours from 
Greenwich time; and zDT is the standard three-letter 
abbreviation for daylight saving time, if observed in the 
area, 


The earth is divided into twenty-four (0 to 23) 
longitudinal standard time zones. Adjacent time zones 
are one hour (15 degrees) apart, beginning at Greenwich 
(0 degrees), with some variations in local legal time. 


For the meridians of North America the principal time 
zones are: 


AST4ADT Atlantic Standard  Time/Daylight 
Saving Time (60 degrees) 
EST5EDT Eastern Standard Time/Daylight 


Saving Time (75 degrees) 
CST6CDT Central Standard Time/Daylight Saving 
Time (90 degrees) 


MST7MDT Mountain Standard Time/Daylight 
Saving Time (105 degrees) 


PST8PDT Pacific Standard Time/Daylight Saving 
Time (120 degrees) 
YST9YDT Yukon Standard Time/Daylight Saving 


Time (135 degrees) 


HST10HDT Hawaiian Standard Time/Daylight 
Saving Time (150 degrees) 


NSTLINDT Nome Standard Time/Daylight Saving 
Time (165 degrees) 


/etc/TZ 


SEE ALSO 


MightyFrame Administrator’s Reference Manual. 
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NAME 

utmp, wtmp — utmp and wtmp entry formats 
SYNOPSIS 

#include <sys/types.h> 

#include <utmp.h> 
DESCRIPTION 


These files, which hold user and accounting information 
for such commands as who(1), periiell), and login(1), 


have the following structure as defined by <utmp.h>: 
#define UTMP_FILE "/etc/utmp” 
#define WTMP_FILE "/etc/wtmp” 


#define ut_name ut_user 


struct utmp { 
char ut_user|8}; 
/* User login name */ 
char ut_id[4]; 
/* /etc/inittab id (usually line #) */ 
char ut_line(12]; 
/* device name (console, Inxx) */ 
short ut_pid; 
/* process id #/ 
short ut_type; 
/* type of entry */ 
struct exit_status { 
short e_termination; 
/* Process termination status */ 
short e_exit; 
/* Process exit status */ 
} ut_exit; 
/* The exit status of a process 
* marked as DEAD_PROCESS. */ 
time_t ut_time; 
/* time entry was made */ 
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/* Definitions for ut_type */ 
#define EMPTY 0 
#define RUN_LVL 1 
#define BOOT TIME 2 
#define OLD-TIME 3 
#define NEW_TIME 4 
#define INIT_PROCESS 5 
/* Process spawned by “init” ¢/ 
#define LOGIN_-PROCESS 6 
/*aA “getty” process waiting for login «/ 
#define USER PROCESS 7 
/* A user process #/ 
#define DEAD_PROCESS 8 
#define ACCOUNTING 9 
#define UTMAXTYPE AQCOUNTING 
/* Largest legal value of ut_type */ 


/* Special strings or formats used in the “ut_line” field */ 
/* when accounting for something other than a process */ 
/* No string for the ut_line field can be more than 11 */ 
/* chars + a NULL in length +/ 

#define RUNLVL_MSG "run-level %c” 

#define BOOT_MSG "system boot” 

#define OTIME_MSG "old time” 

#define NTIME_MSG "new time” 


FILES 
/usr/include/utmp.h 
/etc/utmp 
/etc/wtmp 

SEE ALSO 


login(1), who(1), write(1), getut(3C). 
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NAME . 
intro — introduction to miscellany 


DESCRIPTION 
This section describes miscellaneous facilities such as 
macro packages, character set tables, etc. 
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NAME 
ascii — map of ASCII character set 
SYNOPSIS 
cat /usr/pub/ascii 
DESCRIPTION 
Ascit is a map of the ASCII character set, giving both 
octal and hexadecimal equivalents of each character, to 
be printed as needed. It contains: 
000 nul 001 soh 002 stx 003 etx 004 eot 005 enq 006 ack 007 bel 
010 bs Oll ht O12 ni O18 vt O14 np O16 cr O16 so O17 si 
020 dle 021 del 022 de2 023 dce8 024 dce4 026 nak 026 syn 027 etb 


030 can 031 em 032 sub 033 esc 0384 fs 035 gs 036 rs 037 us 
040 sp O41 | 042 ” 043 # 0449 045% 0468 047 ” 
050 ( 051 ) 052 * 083+ 054 , 055 - 056 057 / 
060 0 061 1 062 2 063 3 064 4 065 & 066 6 067 7 
070 8 O71 9 072 : 073 ; 074 << O78 = O76> 0777? 
100 @ 101 A 102 B 103 C 104 D 105 E 106 F 107 G 
110 H 111 °1 112 J 113 K 114 L 116M 116 N 117 0 
120 P 121 Q 122R 12358 124 T 128U 126V 127W 
130 X 131 Y 182 2 133 | 134 \ 135 | 136 * 137 _ 
140 * 141 a 142 b 143 ¢ 144 d 145 e 146 f 147 ¢ 
160 h 161 i 162 j 163 k 154 1 155m 1560 157 o 
160 p 1861 q 162 r 163 s 164 ¢ 165 u 166 v 167 w 
170 x 171 y 172 s 173 { 174 178 } 176 ~ 177 del 


00 nul O1 soh O2 stx O38 etx O04 eot O05 enq O68 ack O07 bel 
08 bs o9 ht Oa ol Ob vt Oc np Oder Oe so Of si 
10 dle 11 del 12 de2 18 de3 14 de4 15 nak 16 syn 17 etb 
18 can 19 em ta sub Ib ese te fs 1d gs le rs if us 


20 sp 21! 22” 228f# 248 25% 228 27 ° 
28 ( 29 ) 2a * 2b+ 2, 2d - Qe. at / 
30 0 31 1 $2 2 33 3 34 4 35 6 36 6 37 7 
38 8 39 9 Sa: 3b ; 8e< 8d= B8e> 3f7? 
40@ 411A 42B 4830 44D 45E 46F 47G 
48H 491 4a J 4b K 4c L 44M 4eN 4f0 
50P 61Q 52R 68S 64T 55U 56V 57W 
88 X 59 Y ba Z 5b [ be \ 6d | Be * of _ 
60 * 61 3 62 b 63 64d 65 e 66 f 67 ¢ 
68 h 69 i 6a j 6b k 6c 1 6dm Ge n 6f o 
70 p 71 q 72 9 73 8 744 75 u 76 Vv Ti w 
78 x 79 y Jas 7b { Te 7d } 7e 7 7f del 
FILES 
/usr/pub/ascii 


NAME 


DEVICES (5) 


Devices — configuration file for uucp communications 
lines 


SYNOPSIS 


/usr /lib/uucp/Devices 


DESCRIPTION 


/usr/lib/uucp/Devices is a text file that contains 
configuration specifications for communications devices, 
such as modems or direct lines. Each line in the file 
describes a single device and how it communicates with a 
remote system. Comment lines begin with a pound sign 
; The UUCP system uses the 
/usr/lib/uucp/Devices file in conjunction with the 
/usr/lib/uucp/Dialers file to place a call. 


Each line containes five or more fields delimited by 
spaces. The first field is the line type as specified in the 

usr/lib/uucp/Systems file; for direct lines, the first 
field is the name of the remote system. 


The remaining fields give the device name; the calling 
device indicator (such as for 801 calling units), if used; 
the speed, which may be specified as ANY; and the 
name of the caller as _ specified in the 
/usr/lib/uucp/Dialers file. The last field, the name 
of the caller, may be followed by a token format 
ontainne \P or \T); pairs of these dialer name/token 
ormat fields can be repeated if more than one dialer 
must be used in succession to make the connection. If 
no token format is specified, a \D is used for a dialer 
name that references the /usr/lib/uucp/Dialers file; a 
\T is used for internal dialer types such as 801. Unused 
fields are replaced by a hyphen (—). 


EXAMPLE 


FILES 


The following entry configures a 1200-baud intelligent 
modem on device contty for use with UUCP: 


ACU contty - 1200 penril 


/usr/lib/uucp/Devices 
/usr/lib/uucp/Dialers 
/usr/lib/uucp/Systems 


SEE ALSO 
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uucp(1C), dial(3C), Dialers(5). 
MightyFrame Administrator’s Reference Manual. 


DIALERS(5) 


NAME 

Dialers - ACU/modem calling protocols 
SYNOPSIS 

/usr/lib/uucp/Dialers 
DESCRIPTION 


5/86 


Dialers describes the call-placing protocols for 
intelligent modems, ACUs (automatic calling units), and 
other serial switched devices such as data switches. 
When a connection is requested via the UUCP system, 
CTIX looks for a description of the called system in the 
/usr /lib/uucp/Systems file, where the type of line is 
specified for connection to that system. CTIX then 
checks the /usr/lib/uucp/Devices file for a 
description of the line, its speed and its Dialers name. 
The Dialers name given in the Devices file corresponds 
to the first field of the Dialers file. 


Dialers is a text file that contains the dialing script for 
the modems that are configured in the Devices file. 
Each description begins on a new line and has three or 
more fields, delimited by spaces. 


The first field of the description is the name of the 
modem or device as specified in the Devices file. 


The second field specifies the codes used by that 
particular modem for secondary dial tone (=) and pause 
(—); this field enables CTIX to translate from the 
standard 801 codes (= and —) to the special characters 
used by that particular device. 


The remaining fields are the chat script that is necessary 
to establish communication with the modem. 


The modem chat script is composed of command strings 
to the modem and response strings expected in return 
from the modem. The strings consist of ASCII and 
control characters that are recognized by the individual 
modem or device. Spaces delimit the end of a send or 
receive sequence. The first string is an expect string. 


Several modems and switches are already provided in the 
Dialers file. Additional devices can be configured by 
studying the manufacturers’ manuals to determine the 
appropriate send/receive sequences for other modems. 

In the string sequences of the send/receive fields the 
following escape sequences represent control codes: 


\ddd Octal number. 


\c Suppress new line (valid only after \r or at the 
end of a field). 


oe ee 
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\d Delay (two seconds). 


\D Substitute the telephone number (from the 
/usr/lib/uucp/Systems file or cu(iC)), 


without character translation. 
\e Turn off echo checking. 
\E Turn on echo checking (for slow devices). 
\K Insert a BREAK. 
\n New-line. 


\P Pause (a slight delay of one-quarter to one-half 
second). 
\r Carriage return. 


\T Substitute the telephone number (from the 
/usr/lib/uucp/Systems file or cu(1C)), with 
character translation. Character translation 
interprets the 801 codes in the second field and 
expands any symbols found’ in _ the 
/usr/lib/uucp/Dialcodes file. 


Comments delimited by a pound sign (#), spaces, or 
tabs are ignored. Any line terminated by a backslash (\) 
continues to the next line. 


EXAMPLE 


FILES 


5/86 


The following example establishes communication with a 
Ventel modem: 


ventel =&-% “ \r\p\r\c $ <K\T%%\r>\c ONLINE! 


The first field, ‘“‘ventel,”’ is the name of the modem that 
corresponds to a ‘‘ventel”’ caller type in the fifth or 
subsequent field of a Devices file entry. The second 
field describes the modem’s convention for the secondary 


dial tone (&) and a pause (%) command. The 
remaining fields consist of five strings separated by 
spaces. The five strings are interpreted as follows: 


1. The first expect string (””) is null. 


2. Send to the modem a series of carriage returns to 
elicit a prompt. 


3. The modem should respond with a dollar sign ($). 
Send the telephone number (\T) to the modem. 


5. Upon connection the modem should respond with the 
string “ONLINE?’. 


/usr/lib/uucp/Devices 
/usr/lib/uucp/Dialcodes 
/usr/lib/uucp/Systems 


1 
to 
1 
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SEE ALSO 
uucp(1C), dial(3C), Devices(5). 
MightyFrame Administrator’s Reference Manual. 
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NAME 


ENVIRON(5) 


environ — user environment 


DESCRIPTION 


An array of strings called the “environment”’ is made 
available by exec(2) when a process begins. By 
convention, these strings have the form “‘name=value’’. 
The following names are used by various commands: 


PATH The ines of directory prefixes that sh(1), 
timed), nice(1), nohup(1), etc., apply in 
searching for a file known by an incomplete path 
name. The prefixes are separated by colons (:). 
Login(1) sets PATH=:/bin:/usr /bin. 

HOME Name of the user’s login directory, set by 
login(1) from the password file passwd(4). 

TERM The kind of terminal for which output is to be 
prepared. This information is used by 
commands, such as mm(l1), or tplot(1G), which 
may exploit special capabilities of that terminal. 

TZ Time zone information. The format is xxxnzzz 
where xxx is standard local time zone 
abbreviation, n is the difference in hours from 
GMT, and gz is the abbreviation for the 
daylight-saving local time zone, if any; for 
example, EST5EDT. 


Further names may be placed in the environment by the 
export command and ‘‘name=value” arguments in 
sh(1), or by ezec(2). It is unwise to conflict with certain 
shell variables that are frequently exported by .profile 
files: MAIL, PS1, PS2, IFS. 


SEE ALSO 


env(1), lean 
1 


tplot(1G), sh( ), mm(l1), nice(1), nohup(1), ane 


1 (1), 
), exec(2), getenv(3C), profile(4), term(5). 
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NAME 
eqnchar — special character definitions for eqn and neqn 
SYNOPSIS 
eqn /usr/pub/eqnchar [ files | | troff [ options | 
neqn /usr/pub/eqnchar [| files | | nroff { options | 
DESCRIPTION 
Egqnchar contains troff(1) and nroff character definitions 
for constructing characters that are not available on the 
Wang Laboratories, Inc. C/A/T phototypesetter. These 


definitions are primarily intended for use with eqn(1) 
and negqn; eqnchar contains definitions for the following 


characters: 
ciplus ® \| Il square 
citimes  @® langle { circle e) 
wig ~ rangle ) blot a 
— wig = hbar h bullet e 
> wig > ppd L prop « 
< wig < <-> —_ empty @ 
=wig = <=> > member € 
star * l< £ nomem ¢ 
bigstar ®& |> > cup U 
=dot = ang Ee cap a 
orsign Vv rang L incl & 
andsign NN 3dot : subset c, 
=del A thf pa supset ED) 
oppA Vv quarter \, !subset c 
oppE Ss 3quarter Ya !supset 2 
angstrom A degree 
== == < ==> ==> 
FILES 
/usr/pub/eqnchar 
SEE ALSO 


eqn(1), nroff(1), troff(1). 
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NAME 
fentl — file control options 
SYNOPSIS 
#include <fcntl.h> 
DESCRIPTION 
The fentl(2) function provides for control over open files. 


The include file describes requests and arguments to 
fentl and open(2). 


/* Flag values accessible to open(2) and fentl(2) */ 
/* (The first three can only be set by open) */ 


#define OL.RDONLY 0 
#define O_WRONLY 1 
#define OLRDWR 2 
#define O_NDELAY 04 /* Non-blocking I/O */ 
#define O_APPEND 010 /* append 
(writes guaranteed at the end) */ 
#define O_SYNC 020 /* synchronous write option +/ 
#define O_DIRECT 020000 =/* perform direct I/O */ 


#define O_NODIRECT 040000 —_//* disable direct I/O */ 


/* Flag values accessible only to open(2) */ 


#define OLCREAT 00400 /* open with file create 
(uses third open arg)*/ 

#define O_TRUNC 01000 /* open with truncation */ 

#define O_EXCL 02000 /* exclusive open */ 


/* fentl(2) requests */ 


##define F_LDUPFD 0 /* Duplicate fildes */ 
#define F_GETFD 1 /* Get fildes flags */ 
#define F_SETFD 2 /* Set fildes flags */ 
#define F_GETFL 3 /* Get file flags */ 
#define F_SETFL 4 /* Set file flags «/ 
#define F_GETLK 5 /* Get blocking file locks */ 
#define F_SETLK 6 /* Set or clear file locks and fail 
on busy */ 
#define F_SETLKW 7 /* Set or clear file locks and wait 
on busy */ 
/* file segment locking control structure */ 
struct flock { 
short l_type; 
short l_whence; 
long l_start; 
long l_len; /* if 0 then until EOF */ 
int l_pid;  /* returned with F_GETLK */ 
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/* file segment locking types */ 


#define FLRDLCK 01 
#define F_WRLCK 02 
#define F_LUNLCK 03 
SEE ALSO 


fentl(2), open(2). 
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/* Read lock */ 
/* Write lock */ 
/* Remove locks */ 


— 


NAME 


MAN(5) 


man — macros for formatting entries in this manual 


SYNOPSIS 


nroff —man files 


DESCRIPTION 


These troff(1) macros are used to lay out the format of 
the entries of this manual. A skeleton entry may be 
found in the file  uer/ man u Opal /insa0//aleletou. 
These macros are used by the man(1) command. 


Any tert argument below may be one to six ‘‘words”’. 
Double quotes ("") may be used to include blanks in a 
“word”. If text is empty, the special treatment is 
applied to the next line that contains text to be printed. 
For example, .I may be used to italicize a whole line, or 
-SM followed by .B to make small bold text. By default, 
hyphenation is turned off for nroff, but remains on for 


troff. 


Type font and size are reset to default values before each 
paragraph and after processing font- and size-setting 
macros, e.g., .I, .RB, .SM. Tab stops are neither used 
nor set by any macro except .DT and .TH. 


Default units for indents in are ens. When in is 
omitted, the previous indent is used. This remembered 
indent is set to its default value (7.2 ens in troff, 5 ens in 
nroff—this corresponds to 0.5" in the default page size) 
by .TH, .P, and .RS, and restored by .RE. 


-TH t8cn Set the title and entry heading; ¢ is the title, 
8 is the section number, cis extra 
commentary, e.g., ‘“‘local’’, n is new manual 
name. Invokes .DT (see below). 

«SH tezt Place subhead tezt, e.g., SYNOPSIS, here. 

SS tert Place sub-subhead tezt, e.g., Options, here. 

-B tezt Make tezt bold. 


A tezt Make tezt italic. 

‘SM tezt Make tezt 1 point smaller than default point 
size. 

-RI a b Concatenate roman a with italic 5, and 
alternate these two fonts for up to six 
arguments. Similar macros alternate 


between any two of roman, italic, and bold: 
IR .RB .BR .IB_ .BI 


.P Begin a paragraph with normal font, point 
size, and indent. .PP is a synonym for .P 

-HP in Begin paragraph with hanging indent. 

-TP in Begin indented paragraph with hanging tag. 


The next line that contains text to be 
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printed is taken as the tag. If the tag does 
not fit, it is printed on a separate line. 

AP tin Same as .TP in with tag t; often used to get 
an indented paragraph without a tag. 

-RS in Increase relative indent (initially zero). 
Indent all output an extra tn units from the 
current left margin. 

.RE k Return to the kth relative indent level 
(initially, K=1; k=O is equivalent to k—1); 
if k is omitted, return to the most recent 
lower indent level. 

-PM m Produces proprietary markings; where m 
may be P for PRIVATE, N for NOTICE, 
BP for BELL LABORATORIES 
PROPRIETARY, or BR _ for BELL 
LABORATORIES RESTRICTED. 


DT Restore default tab settings (every 7.2 ens in 
troff, 5 ens in nroff). 
«PD v Set the interparagraph distance to v vertical 


spaces. If v is omitted, set the 
interparagraph distance to the default value 
(0.4v in troff, lv in nroff). 


The following strings are defined: 


\#R @ in troff, (Reg.) in nroff. 
\+S Change to default type size. 
\+(Tm Trademark indicator. 
The following number registers are given default values 
by .TH: 
IN Left margin indent relative to subheads 
default is 7.2 ens in troff, 5 ens in nroff). 
LL ine length including IN. 
PD Current interparagraph distance. 
CAVEATS 


In addition to the macros, strings, and number registers 
mentioned above, there are defined a number of internal 
macros, strings, and number registers. Except for names 
predefined by ¢troff and number registers d, m, and y, all 
such internal names are of the form XA, where X is one 
of ), ], and }, and A stands for any alphanumeric 
character. 

If a manual entry needs to be preprocessed by cw(1), 
eqn(1) (or negn), and/or ¢b/(1), it must begin with a 
special line (described in man(1)), causing the man 
command to invoke the appropriate preprocessor(s). 


The programs that prepare the Table of Contents and 
the Permuted Index for this Manual assume the NAME 
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section of each entry consists of a single line of input 
that has the following format: 


name(, name, name ...] \- explanatory text 


The macro package increases the inter-word spaces (to 
eliminate ambiguity) in the SYNOPSIS section of each 
entry. 


The macro package itself uses only the roman font (so 
that one can replace, for example, the bold font by the 
constant-width font—see ew(1)). Of course, if the input 
text of an entry contains requests for other fonts (e.g., .I, 
.RB, \f1), the corresponding fonts must be mounted. 
FILES 
/usr/lib/tmac/tmac.an 
/usr/lib/macros/cmp.|nt].[dt].an 
/usr/lib/macros/ucmp.(nt].an 
/usr/man/{ua]_man/man0/skeleton 
SEE ALSO 
man(1), nroff(1). 
BUGS 
If the argument to .TH contains any blanks and is not 
enclosed by double quotes (""), there will be bird- 
dropping-like things on the output. 


NAME 


MATH(5) 


math — math functions and constants 


SYNOPSIS 


#iinclude <math.h> 


DESCRIPTION 


FILES 


This file contains declarations of all the functions in the 
Math Library (described in Section 3M), as well as 
various functions in the C Library (Section 3C) that 
return floating-point values. 


It defines the structure and constants used by the 
matherr(3M) error-handling mechanisms, including the 
following constant used as an error-return value: 


HUGE The maximum value of a single- 
precision floating-point number. 


The following mathematical constants are defined for 
user convenience: 


MLE i base of natural logarithms 
e). 

M_LOG2E The base-2 logarithm of e. 

M_LOG10E The base-10 logarithm of e. 

M_LN2 The natural logarithm of 2. 

M_LNI10 The natural logarithm of 10. 

M_PI The ratio of the circumference of 


a circle to its diameter. (There 
are also several fractions of its 
reciprocal and its square root.) 


M_SQRT2 The positive square root of 2. 
M_SQRT1_2 The positive square root of 1/2. 


For the definitions of various machine-dependent 
“constants,” see the description of the <values.h> 
header file. 


/usr/include/math.h 


SEE ALSO 


intro(3), matherr(3M), values(5). 
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NAME 


MM(5) 


mm — the MM macro package for formatting documents 


SYNOPSIS 


mm | options | { files | 
nroff —mm | options ] [ files | 
nroff —cm [ options | | files | 


DESCRIPTION 


This package provides a formatting capability for a very 
wide variety of documents. It is the standard package 
used by the BTL typing pools and documentation 
centers. The manner in which a document is typed in 
and edited is essentially independent of whether the 
document is to be eventually formatted at a terminal or 
is to be phototypeset. See the references below for 
further details. 


The —mm option causes nroff and troff(1) to use the 
non-compacted version of the macro package, while the 
em option results in the use of the compacted version, 


thus speeding up the process of loading the macro 
package. 


FILES 
/usr/lib/tmac/tmac.m pointer to the non- 
compacted version of 
the package 
/usr/lib/macros/mm{nt] non-compacted 
version of the package 
/usr/lib/macros/emp.{nt|.[dt].m compacted version of 
the package 
/usr/lib/macros/ucmp.[nt].m initializers for the 
compacted version of 
the package 
SEE ALSO 


mm(1), mmt(1), nroff(1). 

MM-Memorandum Macros by D.W. Smith and J. R. 
Mashey. 

Typing Documents with MM by D. W. Smith and E. M. 
Piskorik. 


NAME 


MPTX(5) 


mptx — the macro package for formatting a permuted 
index 


SYNOPSIS 


nroff —mptx [{ options | [ files | { options | [ files ] 


DESCRIPTION 


FILES 


This package provides a definition for the .xx macro 
used for formatting a permuted index as produced by 
ptz(1). This package does not provide any other 
formatting capabilities such as headers and footers. If 
these or other capabilities are required, the mptz macro 
package may be used in conjuction with the MM macro 
package. In this case, the —mptx option must be 
invoked after the —mm call. For example: 


nroff —cm —mptx file 
or 
mm -mptx file 


/usr/lib/tmac/tmac.ptx pointer to the non-compacted 
version of the package 

/usr/lib/macros/ptx non-compacted version of the 
package 


SEE ALSO 


mm(1), nroff(1), ptx(1), mm(5). 
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NAME 
mv — a troff macro package for typesetting view graphs 
and slides 
SYNOPSIS 
mvt [ —a | [ options | [| files ] 
troff { —a | | -rX1 ] —mv [ options | [ files | 
DESCRIPTION 


This package makes it easy to typeset view graphs and 

rojection slides in a variety of sizes. A few macros 
(briefly described below) accomplish most of the 
ormatting tasks needed in making transparencies. All of 
the facilities of troff(1), cw(1), eqn(1), and ¢tb/(1) are 
available for more difficult tasks. 


The output can be previewed on most terminals, and, in 
particular, on the Tektronix 4014, as well as on the 
Versatec printer. For these two devices, specify the 
—rX1 option (this option is automatically specified by 
the mvt command-—q.v.—when that command is invoked 
with the -T4014 or —Tvp options). To preview output 
on other terminals, specify the —a option. 


ae available macros are: 


S {n} {] {d)  Foil-start macro; foil size is to be 
7X7"; n is the foil number, ¢ is the 
foil identification, d is the date; the 
foil-start. macro resets all parameters 
(indent, point size, etc.) to initial 
default values, except for the values 
of t and d arguments inherited from a 
previous foil-start macro; it also 
invokes the .A macro (see below). 


The naming convention for this and 
the following eight macros is that the 
first character of the name (V or S) 
distinguishes between view graphs and 
slides, respectively, while the second 
character indicates whether the foil is 
square (S), small wide (w), small high 
(h), big wide (Ww ), or big high (H). 
lides are ‘“‘skinnier” than the 
corresponding view graphs: the ratio 
of the longer dimension to the shorter 
one is larger for slides than for view 
graphs. As a result, slide foils can be 
used for view graphs, but not vice 
versa; on the other hand, view graphs 
can accommodate a bit more text. 


a ee 


-Vw |[n| [1] [d 
-Vh_ [n] [¢ (d 
VW [nl] [1] [d 
-VH [n] [¢] [d 
Sw [n] [¢] [d] 
Sh [nl] [#] [d] 
SW [nl [1] [d] 
SH [nl [1] [d] 
A [z 

-B [m [sl | 
C [ms] ] 
-D[m [3] | 
-T string 
JI {in} {a [a] | 
S [pl [! 
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Same as .VS, except that foil size is 
7" wide X 5! high. 

Same as .VS, except that foil size is 
BM yg 7 

Same as .VS, except that foil size is 
7 Xx5.4"", 

Same as .VS, except that foil size is 
TH yg gl! 

Same as .VS, except that foil size is 
TH yall, 

Same as .VS, except that foil size is 
BM 7 

Same as .VS, except that foil size is 
(hee ase an 

Same as .VS, except that foil size is 
7 «gl, 

Place text that follows at the first 
indentation level (left margin); the 
presence of z suppresses the '% line 
spacing from the preceding text. 

Place text that follows at the second 
indentation level; text is preceded by 
a mark; m is the mark (default is a 
large bullet); s is the increment or 
decrement to the point size of the 
mark with respect to the prevailing 
point size (default is 0); if s is 100, it 
causes the point size of the mark to 
be the same as that of the default 
mark. 

Same as .B, but for the third 
indentation level; default mark is a 
dash. 

Same as .B, but for the fourth 
indentation level; default mark is a 
small bullet. 

String is printed as an _ over-size, 
centered title. 

Change the current text indent (does 
not affect titles); tn is the indent (in 
inches unless dimensioned, default is 
0); if in is signed, it is an increment 
or decrement; the presence of a 
invokes the .A macro (see below) and 
passes z (if any) to it. 

Set the point size and line length; p is 
the point size (default is “‘previous’’); 
if p is 100, the point size reverts to 
the inttial default for the current foil- 
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FILES 
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start macro; if p is signed, it is an 
increment or decrement (default is 18 
for .VS, .VH, and .SH, and 14 for 
the other foil-start macros); | is the 
line length (in inches unless 
dimensioned; default is 4.2! for .Vh, 
3.8" for .Sh, 5 for .SH, and 6" for 
the other foil-start macros). 

DF nf (n f...] 
Define font positions; may not appear 
within a foil’s input text (i.e., it may 
only appear after all the input text for 
a foil, but before the next foil-start 
macro); n is the position of font f; up 
to four ‘“‘n f” pairs may be specified; 
the first font named becomes the 
revailing font; the initial setting is 
H is a synonym for G): 

DF 1H2138B45 

-DV {a} [6] {c] [d| Alter the vertical spacing between 
indentation levels; a is the spacing for 
A, 6 is for .B, ¢ is for .C, and d is 
for .D; all non-null arguments must 
be dimensioned; null arguments leave 
the corresponding spacing unaffected; 
initial setting is: 

DV .5v .5v .5v Ov 

-U str [str2]_ Underline sfr1 and concatenate str2 
(if any) to it. 

The last four macros in the above list do not cause a 

break; the .I macro causes a break only if it is invoked 


with more than one argument; all the other macros cause 
a break. 


The macro package also recognizes the following upper- 
case synonyms for the corresponding lower-case troff 
requests: 

AD .BR .CE .FI HY .NA .NF .NH .NX .SO 
SP .TA .TI 


The Tm string produces the trademark symbol. 


The input tilde (~) character is translated into a blank 
on output. 


See the user’s manual cited below for further details. 


/usr/lib/tmac/tmac.v 
/usr/lib/macros/vmca 
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SEE ALSO 
ew(1), eqn(1), mmt(1), ol); troff(1). 
Macro Package for View Graphs and Slides by 


T. A. Dolotta and D. W. Smith. 

BUGS 
The .VW and .SW foils are meant to be 9!' wide by 7" 
high, but because the typesetter paper is generally only 
8!" wide, they are printed 7!' wide by 5.4" high and have 
to be enlarged by a factor of 9/7 before use as view 
graphs; this makes them less than totally useful. 


NAME 


PROF (5) 


prof — profile within a function 


SYNOPSIS 


#define MARK 
#include <prof.h> 


void MARK (name) 


DESCRIPTION 


MARK will introduce a mark called name that will be 
treated the same as a function entry point. Execution of 
the mark will add to a counter for that mark, and 
program-counter time spent will be accounted to the 
immediately preceding mark or to the function if there 
are no preceding marks within the active function. 


Name may be any combination of up to six letters, 
numbers or underscores. Each name in a single 
compilation must be unique, but may be the same as any 
ordinary program symbol. 


For marks to be effective, the symbol MARK must be 
defined before the header file <prof.h> is included. 
This may be defined by a preprocessor directive as in the 
synopsis, or by a command line argument, i.e: 


cc —p —-DMARK foo.c 
If MARK is not defined, the MARK(name) statements 


may be left in the source files containing them and will 
be ignored. 


EXAMPLE 


In this example, marks can be used to determine how 
much time is spent in each loop. Unless this example is 
compiled with MARK defined on the command line, the 
marks are ignored. 


#include <prof.h> 
foo( ) 
{ 


int i, j; 


MARK (loop1); 
for (i = 0; 1 < 2000; i++) { 


} 
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MARK (loop2); 
for (j = 0; j < 2000; j++) { 
} 
SEE ALSO 


prof(1), profil(2), monitor(3C). 
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NAME 
regexp — regular expression compile and match routines 


SYNOPSIS 
#define INIT <declarations > 
#define GETC() <getc code> 
#define PEEKC() <peekc code> 
#define PETRA. <ungetc code> 
#define RETURN(pointer) <return code> 
#define ERROR(val) <error code> 


#include <regexp.h> 


char *compile (instring, expbuf, endbuf, eof) 
char *instring, *expbuf, *endbuf; 
int eof; 


int step (string, expbuf) 
char *string, *expbuf; 


extern char *locl, *loc2, *locs; 
extern int circf, sed, nbra; 


DESCRIPTION 

This page describes general-purpose regular expression 
matching routines in the form of ed(1), defined in 
/usr/include/regexp.h. Programs such as_ ed(1), 
sed(1), grep(1), 6s(1), ezpr(1), etc., which perform 
regular expression matching use this source file. In this 
way, only this file need be changed to maintain regular 
expression compatibility. 

The interface to this file is unpleasantly complex. 
Programs that include this file must have the following 
five macros declared before the “#include <regexp.h>”’ 


statement. These macros are used by the compile 
routine. 


GETOC( ) Return the value of the next 
character in the regular expression 
pattern. Successive calls to 
GETC() should return successive 
characters of the regular 
expression. 

PEEKC( ) Return the next character in the 
regular expression. Successive 
calls to PEEKC() should return 
the same character (which should 
also be the next character 
returned by GETC( )). 


UNGETC(c) Cause the argument c to be 
returned by the next call to 


a 
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GETC() (and PEEKC()). No 
more that one character of 
pushback is ever needed and this 
character is guaranteed to be the 
last character read by GETC{( ). 
The value of the macro 
UNGETC(c) is always ignored. 


RETURN(potnter) This macro is used on normal exit 
of the compile routine. The value 
of the argument pointer is a 
pointer to the character after the 
last character of the compiled 
regular expression. This is useful 
to programs which have memory 
allocation to manage. 


ERROR( val) This is the abnormal return from 
the compile routine. The 
argument val is an error number 
see table below for meanings). 

his call should never return. 


ERROR MEANING 

11 Range endpoint too large. 

16 Bad number. 

25 ‘‘\ digit” out of range. 

36 Illegal or missing delimiter. 

41 No remembered search string. 

42 \ \) NC 

43 oo many \ 

44 More than 5 numbers given in 
\{ \}- 

45 po after \. 

46 i number exceeds second in 

49 tf imbalance. 

50 egular expression overflow. 


The syntax of the compile routine is as follows: 
compile(instring, expbuf, endbuf, eof) 


The first parameter instring is never used explicitly by 
the compile routine but is useful for programs that pass 
down different pointers to input characters. It is 
sometimes used in the INIT declaration (see below). 
Programs which call functions to input characters or 
have characters in an external array can pass down a 
value of ((char *) 0) for this parameter. 


The next parameter ezpbuf is a character pointer. It 
points to the place where the compiled regular expression 


-2- 
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will be placed. 


The parameter endbuf is one more than the highest 
address where the compiled regular expression may be 
laced. If the compiled expression cannot fit in 
lendhupe ezpbuf) bytes, a call to ERROR(50) is made. 


The parameter eof is the character which marks the end 
of the regular expression. For example, in ed(1), this 
character is usually a /. 


Each program that includes this file must have a 
#define statement for INIT. This definition will be 
placed right after the declaration for the function 
comptle and the opening curly brace ({). It is used for 
dependent declarations and initializations. Most often it 
is used to set a register variable to point the beginning of 
the regular expression so that this register variable can 
be used in the declarations for GETC( ), PEEKC() and 
UNGETC( ). Otherwise it can be used to declare external 
variables that might be used by GETC( ), PEEKC( ) and 
UNGETC(). See the example below of the declarations 
taken from grep(1). 


There are other functions in this file which perform 
actual regular expression matching, one of which is the 
function step. The call to step is as follows: 


step(string, expbuf) 


The first parameter to step is a pointer to a string of 
characters to be checked for a match. This string should 
be null terminated. 


The second parameter ezpbuf is the compiled regular 
expression which was obtained by a call of the function 
compile. 


The function step returns non-zero if the given string 
matches the regular expression, and zero if the 
expressions do not match. If there is a match, two 
external character pointers are set as a side effect to the 
call to step. The variable set in step is locl. This is a 
pointer to the first character that matched the regular 
expression. The variable loc2, which is set by the 
function advance, points to the character after the last 
character that matches the regular expression. Thus if 
the regular expression matches the entire line, /oc1 will 
point to the first character of string and loc2 will point 
to the null at the end of string. 


Step uses the external variable ectref which is set by 
compile if the regular expression begins with *. If this is 
set then step will try to match the regular expression to 
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the beginning of the string only. If more than one 
regular expression is to be compiled before the first is 
executed the value of ctref should be saved for each 
compiled expression and ctrcf should be set to that saved 
value before each call to step. 


The function advance is called from step with the same 
arguments as step. The purpose of step is to step 
through the string argument and call advance until 
advance returns non-zero indicating a match or until the 
end of string is reached. If one wants to constrain string 
to the beginning of the line in all cases, step need not. be 
called; simply call advance. 


When advance encounters a * or \{ \} sequence in the 
regular expression, it will advance its pointer to the 
string to be matched as far as possible and will 
recursively call itself trying to match the rest of the 
string to the rest of the regular expression. As long as 
there is no match, advance will back up along the string 
until it finds a match or reaches the point in the string 
that initially matched the * or \{ \}. It is sometimes 
desirable to stop this backing up before the initial point 
in the string is reached. If the external character pointer 
loca is equal to the point in the string at sometime 
during the backing up process, advance will break out of 
the loop that backs up and will return zero. This is used 
by ed(1) and sed(1) for substitutions done globally (not 
just the first occurrence, but the whole line) so, for 
example, expressions like s/y*//g do not loop forever. 


The additional external variables sed and nbra are used 
for special purposes. 


EXAMPLES 
The following is an example of how the regular 
expression macros and calls look from grep(1): 


#define INIT register char *sp = instring; 


#define GETC( *sp++) 
#define PEEKC( ) *sp) 
#define UNGETC(c —~sp) 
#define RETURN(c return; 
#define ERROR(c regerr( ) 


#include <regexp.h> 
. (void) compile(*argv, expbuf, &expbuf[ESIZE], '\0'); 


if (step(linebuf, expbuf)) 
succeed( ); 
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FILES 
/usr/include/regexp.h 
SEE ALSO 
bs(1), ed(1), expr(1), grep(1), sed(1). 
BUGS 
The handling of ctref is kludgy. 
The actual code is probably easier to understand than 
this manual page. 


NAME 


DESCRIPTION 


FILES 
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stat — data returned by stat system call 


a SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 


The system calls stat and fatat return data whose 
structure is defined by this include file. The encoding of 
the field st_mode is defined in this file also. 


/* 


* Structure of the result of stat 


| 
struct 


{ 


}i 


#define 
#define 
#define 
# define 
#define 
#define 
#define 
#define 


#define 


#define 
#define 


#define 


stat 


dev_t st_dev; 


ino_t st_ino; 
ushort st_mode; 
short st_nlink; 


ushort —st_uid; 
ushort _st_gid; 
dev_t st_rdey; 
off_t st_size; 


time_t st_atime; 
time_t st mtime; 


time_t  st_ctime; 


S_IFMT 0170000 
S_IFDIR 0040000 
S_IFCHR 0020000 
S_IFBLK 0060000 
S_IFREG 0100000 
S_IFIFO 0010000 
S_ISUID 04000 

S_ISGID 02000 


S_ISVTX 01000 


S_IREAD 00400 

S_IWRITE 
00200 

S_IEXEC 00100 


/* type of file */ 

/* directory */ 

/* character special */ 

/* block special */ 

/* regular */ 

/* fifo */ 

/* set user id on execution */ 


/* set group id on execution */ 


/* save swapped text even after use */ 
/* read permission, owner */ 


/* write permission, owner */ 


/* execute/search permission, owner */ 


/usr/include/sys/types.h 
/usr/include/sys/stat.h 


= fs 
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SEE ALSO 
stat(2), types(5). 


NAME 


TERM(5) 


term — conventional names for terminals 


oa DESCRIPTION 


These names are used by certain commands (e.g., 
tabs(1), eee and are maintained as part of the shell 


environment (see sh(1), profile(4), and envtron(5)) in the 

variable $TERM: 

pt Convergent Technologies Programmable 
Terminal 

gt Convergent Technologies Graphics Terminal 

freedom Liberty Freedom 100 

1520 Datamedia 1520 

1620 DIABLO 1620 and others using the HyType II 
printer 

1620-12 
same, in 12-pitch mode 

2621 Hewlett-Packard HP2621 series 

2631 Hewlett-Packard 2631 line printer 

2631-c Hewlett-Packard 2631 line printer - compressed 
mode 

2631-e Hewlett-Packard 2631 line printer - expanded 
mode 

— 2640 Hewlett-Packard HP2640 series 

2645 Hewlett-Packard HP264n series (other than the 
2640 series) 

300 DASI/DTC/GSI 300 and others using the 
HyType I printer 

300-12 same, in 12-pitch mode 

300s  DASI/DTC/GSI 300s 

382 DTC 382 

300s—12 same, in 12-pitch mode 

3045 Datamedia 3045 

33 TELETYPE Model 33 KSR 

37 TELETYPE Model 37 KSR 

40-2 TELETYPE Model 40/2 

40-4 TELETYPE Model 40/4 

4540 TELETYPE Model 4540 

3270 IBM Model 3270 

4000a_ Trendata 4000a 

4014 TEKTRONIX 4014 

43 TELETYPE Model 43 KSR 

450 DASI 450 (same as Diablo 1620) 

~ 450-12 same, in 12-pitch mode 

735 Texas Instruments TI735 and T1725 

745 Texas Instruments T1745 

dumb generic name for terminals that lack reverse 


line-feed and other special escape sequences; 
likely to work when the real terminal type is 


sts 
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not known to the program 

sync generic name for synchronous TELETYPE 4540 
compatible terminals 

Ip generic name for a line printer 


Up to 8 characters, chosen from [-a-—z0-9], make up a 
basic terminal name. Terminal sub-models and 
operational modes are distinguished by suffixes beginning 
with a —. Names should generally be based on original 
vendors, rather than local distributors. A terminal 
acquired from one vendor should not have more than one 
distinct basic name. 


Commands whose behavior depends on the type of 
terminal should accept arguments of the form —Tterm 
where term is one of the names given above; if no such 
argument is present, such commands should obtain the 
terminal type from the environment variable $TERM, 
which, in turn, should contain term. 


SEE ALSO 


BUGS 


ey mm(1), nroff(1), tplot(1G), sh(1), stty(1), tabs(1), 
profile(4), environ(5). 


This is a small candle trying to illuminate a large, dark 
problem. Programs that ought to adhere to this 
nomenclature do so somewhat fitfully. 
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NAME 
types — primitive system data types 


SYNOPSIS 
#include <sys/types.h> 


DESCRIPTION 
The data types defined in the include file are used in 
CTIX code; some data of these types are accessible to 
user code: 


typedef struct { int rid]; } * physadr; 
typedef long addr_t; 

typedef char * caddr_t; 

typedef unsigned int  uint; 

typedef unsigned short ushort; 


typedef ushort ino_t; 
typedef short ent_t; 
typedef long time_t; 
typedef int label_t[13]; 
typedef short dev_t; 
typedef long off_t; 
typedef long paddr_t; 
typedef long key_t; 


The form daddr_t is used for disk addresses except in an 
i-node on disk, see fs(4). Times are encoded in seconds 
since 00:00:00 GMT, January 1, 1970. The major and 
minor parts of a device code specify kind and unit 
number of a device. Offsets are measured in bytes from 
the beginning of a file. The /abel_t variables are used to 
save the processor state while another process is running. 


SEE ALSO 
fs(4). 
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NAME 

values — machine-dependent values 
SYNOPSIS 

#include <values.h> 
DESCRIPTION 


This f ile contains a set of manifest constants, 
conditionally defined for particular processor 
architectures. 


The model assumed for integers is binary representation 
(one’s or two’s complement), where the sign is 
represented by the value of the igh-order bit. 


BITS(type ) The number of bits in a specified 
type (e.g., int 
HIBITS The value of a short integer with 


only the high-order bit set (in 
most implementations, 0x8000). 


HIBITL The value of a long integer with 
only the high-order bit set (in 
most implementations, 
0x80000000). 

HIBITI The value of a regular integer 


with only the high-order bit set 
(usually the same as HIBITS or 


HIBITL). 

MAXSHORT The maximum value of a signed 
short integer (in most 
implementations, Ox7FFF = 
32767). 

MAXLONG The maximum value of a site 
long integer ost 
implementations, 0x7 FFFFFF = = 
2147483647). 

MAXINT The maximum value of a signed 


regular integer (usually the same 
as MAXSHORT or MAXLONG). 


MAXFLOAT, LN_MAXFLOAT The maximum value of 
a single-precision 
floating-point number, 
and its natural 
logarithm. 


MAXDOUBLE, LN_MAXDOUBLE The maximum value of 
a double-precision 
floating-point number, 
and its natural 
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logarithm. 


MINFLOAT, LN_MINFLOAT The minimum positive 


value of a single- 
precision floating-point 
number, and its 
natural logarithm. 


MINDOUBLE, LN_MINDOUBLE The minimum positive 


FSIGNIF 


DSIGNIF 


FILES 
/usr/include/values.h 


SEE ALSO 
intro(3), math(5). 


value of a  double- 
precision floating-point 
number, and its 
natural logarithm. 


The number of significant bits in 
the mantissa of a single-precision 
floating-point number. 


The number of significant bits in 
the mantissa of a double-precision 
floating-point number. 
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NAME 

varargs — handle variable argument list 
SYNOPSIS 

#tinclude <varargs.h> 

va_alist 

va_dcl 


void va_start(pvar) 
va_list pvar; 


type va_arg(pvar, type) 
va_list pvar; 

void va_end(pvar) 
va_list pvar; 


DESCRIPTION 
This set of macros allows portable procedures that 
accept variable argument lists to be written. Routines 
that have variable argument lists (such as printf{(3S)) but 
do not use varargs are inherently nonportable, as 
different machines use different argument-passing 
conventions. 


va_alist is used as the parameter list in a function 
header. 

va_del is a declaration for va_alist. No semicolon 
should follow va_del. 

va_list is a type defined for the variable used to 
traverse the list. 


va_start is called to initialize pvar to the beginning of 
the list. 

va_arg will return the next argument in the list pointed 
to by puar. Type is the type the argument is expected 
to be. Different types can be mixed, but it is up to the 
routine to know what type of argument is expected, as it 
cannot be determined at runtime. 


va_end is used to clean up. 


Multiple traversals, each bracketed by va_start 
va_end, are possible. 

EXAMPLE 
This example is a possible implementation of execl(2). 


#include <varargs.h > 
#define MAXARGS 100 


/* execl is called by 
execl(file, arg1, arg2, ..., (char *)0); 


ae ee 
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* 


execl(va_alist) 
va_del 


va_list ap; 

char *file; 

char *args[|MAXARGS]; 
int argno = 0; 


va_start(ap); 

file = va_arg(ap, char *); 

while ((args[argno++| = va_arg(ap, char *)) 
!= (char *)0) 


va_end(ap) : 
return execv(file, args); 


} 


SEE ALSO 


BUGS 


exec(2), printf(3S). 


It is up to the calling routine to specify how many 
arguments there are, since it is not always possible to 
determine this from the stack frame. For example, ezecl 
is passed a zero pointer to signal the end of the list. 
Printf can tell how many arguments are there by the 
format. 

It is non-portable to specify a second argument of char, 
short, or float to va_arg, since arguments seen by the 
called function are not char, short, or float. C converts 
char and short arguments to tnt and converts float 
arguments to double before passing them to a function. 
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NAME 
intro — introduction to games 


ao DESCRIPTION 
This section describes the recreational and educational 
programs found in the directory /usr/games. The 
availability of these programs may vary from system to 
system. 
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ae : Bee ty; BY 


NAME 4 
advent — explore Colossal Cave 

SYNOPSIS 
/usr/games/advent 

DESCRIPTION 


Advent is Adventure, the original computer-moderated 
role-playing game. It accepts commands of one or two 
English words and responds by describing situations and 
how your commands affect them. The object of the 
game is to retrieve the treasures from Colossal Cave, 
placing them in the Well House. 


Part of the game is figuring out the useful commands, 
but the following are worth knowing in advance: 


help Basic hints. 
quit End the game and give final score. 


suspend Save the game’s current state in a file called 
$HOME/adv.susp. The next time you play 
the game will you automatically start from 
where you left off instead of from the 


beginning. 
FILES 
/usr/games/advfiles/* 
$HOME/adv.susp 
WARNINGS 


Kibitzing this sort of game properly is a fine art. People 
who tell you about the shortcuts can spoil the game, 
especially in the early stages. 


Some movement verbs, such as follow, work only well 
enough to get you lost. Compass points are more (but 
not completely) reliable. 


Only the first five characters of an input word are 
significant. 


The command vocabulary and control of objects is 
limited. But discovering limitations has become part of 
the game. 


a 
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NAME 

arithmetic — provide drill in number facts 
SYNOPSIS 

/usr/games/arithmetic { +—x/ | | range | 
DESCRIPTION 


Artthmetic types out simple arithmetic problems, and 
waits for an answer to be typed in. If the answer is 
correct, it types back ‘‘Right!’’, and a new problem. If 
the answer is wrong, it replies ‘‘What?’”’, and waits for 
another answer. Every twenty problems, it publishes 
statistics on correctness and the time required to answer. 


To quit the program, type an interrupt (delete). 


The first optional argument determines the kind of 
problem to be generated; +, —, x, and / respectively 
cause addition, subtraction, multiplication, and division 
problems to be generated. One or more characters can 
be given; if more than one is given, the different types of 
problems will be mixed in random order; default is +-. 


Range is a decimal number; all addends, subtrahends, 
differences, multiplicands, divisors, and quotients will be 
less than or equal to the value of range. Default range 
is 10. 


At the start, all numbers less than or equal to range are 
equally likely to appear. If the respondent makes a 
mistake, the numbers in the problem which was missed 
become more likely to reappear. 


As a matter of educational philosophy, the program will 
not give correct answers, since the learner should, in 
principle, be able to calculate them. Thus the program 
is intended to provide drill for someone just past the first 
learning stage, not to teach number facts de novo. For 
almost all users, the relevant statistic should be time per 
problem, not percent correct. 


NAME 
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back — the game of backgammon 


SYNOPSIS 


/usr /games/back 


DESCRIPTION 


FILES 


BUGS 


Back is a program which provides a partner for the game 
of backgammon. It is designed to play at three different 
levels of skill, one of which you must select. In addition 
to selecting the opponent’s level, you may also indicate 
that you would like to roll your own dice during your 
turns (for the superstitious players). You will also be 
given the opportunity to move first. The practice of 
each player rolling one die for the first move is not 
incorporated. 


The points are numbered 1-24, with 1 being white’s 
extreme inner table, 24 being brown’s inner table, 0 
being the bar for removed white pieces and 25 the bar 
for brown. For details on how moves are expressed, type 
y when back asks “‘Instructions?”’ at the beginning of the 
game. When back first asks ‘““Move?”’, type ? to see a 
list of move options other than entering your numerical 
move. 


When the game is finished, back will ask you if you want 
the log. If you respond with y, back will attempt to 
append to or create a file back.log in the current 
directory. 


/usr/games/lib/backrules __ rules file 
Gn ibe log temp file 
ack.log log file 


“expert’’, and it 


The only level really worth playing is 
only plays the forward game. 

Back will complain loudly if you attempt to make too 
many moves in a turn, but will become very silent if you 
make too few. 

Doubling is not implemented. 

Back will occasionally not allow a legal move when you 
have a man on the bar. 
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NAME 
bj -— the game of black jack 


aries SYNOPSIS 
/usr/games/bj 
DESCRIPTION 
By is a serious attempt at simulating the dealer in the 


game of black jack (or twenty-one) as might be found in 
Reno. The following rules apply: 


The bet is $2 every hand. 


A player “natural” (black jack) pays $3. A dealer 
natural loses $2. Both dealer and player naturals is 
a ‘“‘push” (no money exchange). 


If the dealer has an ace up, the player is allowed to 
make an “insurance” bet against the chance of a 
dealer natural. If this bet is not taken, play 
resumes as normal. If the bet is taken, it is a side 
bet where the player wins $2 if the dealer has a 
natural and loses $1 if the dealer does not. 


If the player is dealt two cards of the same value, 
he is allowed to “double”. He is allowed to play 

— two hands, each with one of these cards. (The bet 
is doubled also; $2 on each hand.) 


If a dealt hand has a total of ten or eleven, the 
player may ‘‘double down’’. He may double the 
bet ($2 to $4) and receive exactly one more card on 
that hand. 


Under normal play, the player may “‘hit”’ (draw a 
card) as long as his total is not over twenty-one. If 
the player ‘busts’ (goes over twenty-one), the 
dealer wins the bet. 


When the player ‘“‘stands” (decides not to hit), the 
dealer hits until he attains a total of seventeen or 
more. If the dealer busts, the player wins the bet. 


If both player and dealer stand, the one with the 
largest total wins. A tie is a push. 


The machine deals and keeps score. The following 
questions will be asked at appropriate times. Each 
question is answered by y followed by a new-line for 


— “yves’’, or just new-line for “‘no’’. 
? (means, ‘‘do you want a hit?’’) 
Insurance? 


Double down? 
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Every time the deck is shuffled, the dealer so states and 
the “action” (total bet) and “standing” (total won or 
lost) is printed. To exit, hit the interrupt key (DEL) and 
the action and standing will be printed. 


_—_ 


NAME 
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craps — the game of craps 


SYNOPSIS 


/usr/games/craps 


DESCRIPTION 


Craps is a form of the game of craps that is played in 
Las Vegas. The program simulates the roller, while the 
user (the player) places bets. The player may choose, at 
any time, to bet with the roller or with the House. A 
bet of a negative amount is taken as a bet with the 
House, any other bet is a bet with the roller. 


The player starts off with a “bankroll” of $2,000. 
The program prompts with: 
bet? 


The bet can be all or part of the player’s bankroll. Any 
bet over the total bankroll is rejected and the program 
prompts with bet? until a proper bet is made. 


Once the bet is accepted, the roller throws the dice. The 
following rules apply (the player wins or loses depending 
on whether the bet is placed with the roller or with the 
House; the odds are even). The first roll is the roll 
immediately following a bet: 


1. On the first roll: 


7 or 11 wins for the roller; 

2, 3, or 12 wins for the House; 

any other number is the potnt, roll again 
(Rule 2 applies). 


2. On subsequent rolls: 
point roller wins; 
House wins; 
any other number roll again. 


If a player loses the entire bankroll, the House will offer 
to lend the player an additional $2,000. The program 
will prompt: 

marker? 


A yes (or y) consummates the loan. Any other reply 
terminates the game. 


If a player owes the House money, the House reminds the 
player, before a bet is placed, how many markers are 
outstanding. 


If, at any time, the bankroll of a player who has 
outstanding markers exceeds $2,000, the House asks: 
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Repay marker? 


A reply of yes (or y) indicates the player’s willingness to 
repay the loan. If only 1 marker is outstanding, it is 
immediately repaid. However, if more than 1 marker are 
outstanding, the House asks: 


How many? 


markers the player would like to repay. If an invalid 
number is entered (or just a carriage return), an 
appropriate message is printed and the program will 
prompt with How many? until a valid number is 
entered. 


If a player accumulates 10 markers (a total of $20,000 
borrowed from the House), the program informs the 
player of the situation and exits. 


Should the bankroll of a player who has outstanding 
markers exceed $50,000, the total amount of money 
borrowed will be automatically repaid to the House. 


Any player who accumulates $100,000 or more breaks 
the bank. The program then prompts: 


New game? 
to give the House a chance to win back its money. 


Any reply other than yes is considered to be a no 
(except in the case of bet? or How many?). To exit, 
send an interrupt (break), DEL, or control-D. The 
program will indicate whether the player won, lost, or 
broke even. 


MISCELLANEOUS 
The random number generator for the die numbers uses 
the seconds from the time of day. Depending on system 
usage, these numbers, at times, may seem strange but 
occurrences of this type in a real dice situation are not 
uncommon. 


— 


NAME 


FISH(6) 


fish — play “Go Fish” 


SYNOPSIS 


/usr /games/fish 


DESCRIPTION 


Fish plays the game of Go Fish, a childrens’ card game. 
The Object is to accumulate ‘books’ of 4 cards with the 
same face value. The players alternate turns; each turn 
begins with one player selecting a card from his hand, 
and asking the other player for all cards of that face 
value. If the other player has one or more cards of that 
face value in his hand, he gives them to the first player, 
and the first player makes another request. Eventually, 
the first player asks for a card which is not in the second 
player’s hand: he replies ‘GO FISH!’ The first player 
then draws a card from the ‘pool’ of undealt cards. If 
this is the card he had last requested, he draws again. 
When a book is made, either through drawing or 
requesting, the cards are laid down and no further action 
takes place with that face value. 


To play the computer, simply make guesses by typing a, 

, 4, 5, 6, 7, 8, 9, 10, j, q, or k when asked. Hitting 
return gives you information about the size of my hand 
and the pool, and tells you about my books. Saying ‘p’ 
as a first guess puts you into ‘pro’ level; the default is 
pretty dumb. 
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NAME 

fortune — print a random, hopefully interesting, adage 
SYNOPSIS 

/usr/games/fortune [ — ] [ —wslao } 


DESCRIPTION 
Fortune with no arguments prints out a random adage. 
The flags mean: 


—w Waits before termination for an amount of time 
calculated from the number of characters in the 
message. This is useful if it is executed as part of 
the logout procedure to guarantee that the message 
can be read before the screen is cleared. 


~s Short messages only. 
—l Long messages only. 


~o Choose from an alternate list of adages, often used 
for potentially offensive ones. 
-a Choose from either list of adages. 
FILES 
/usr/games/lib/fortunes.dat 


AUTHOR 
Ken Arnold 


NAME 
hangman — guess the word 


HANGMAN(6) 


SYNOPSIS 


/usr/games/hangman | arg | 


DESCRIPTION 


FILES 


BUGS 


Hangman chooses a word at least seven letters long from 
a dictionary. The user is to guess letters one at a time. 


The optional argument arg names an_ alternate 
dictionary. 


/usr/lib/w2006 


Hyphenated compounds are run together. 
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NAME 
maze — generate a maze 

SYNOPSIS 
/usr/games/maze [ seed [ d] [n] [ b ] |] 

DESCRIPTION 
Maze prints a maze. It uses the system clock as the 
random number seed. If seed is specified, maze uses it 
as the seed and shows the solution. An n suppresses the 
solution, a b shows backouts, and a d_ provides 
debugging information. 

BUGS 


Some mazes (especially small ones) have no solutions. 
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NAME 
moo — guessing game 


SYNOPSIS 
/usr /games/moo 


DESCRIPTION 

Moo is a guessing game imported from England. The 
computer picks a number consisting of four distinct 
decimal digits. The player guesses four distinct digits 
being scored on each guess. A “cow” is a correct digit in 
an incorrect position. A ‘“‘bull’” is a correct digit in a 
correct position. The game continues until the player 
guesses the number (a score of four bulls). 
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NAME 

number — convert Arabic numerals to English 
SYNOPSIS 

/usr /games/number 
DESCRIPTION 


Number copies the standard input to the standard 
output, changing each decimal number to a fully spelled 
out version. 


NAME 


QUIZ (6) Nie dine 


quiz — test your knowledge 


“ey SYNOPSIS 


/usr/games/quiz { -i file |] [ -t ] [ categoryl 
category2 | 


DESCRIPTION 


FILES 


Qutz gives associative knowledge tests on various 
subjects. It asks items chosen from category! and 
expects answers from category2, or vice versa. If no 
categories are specified, gutz gives instructions and lists 
the available categories. 


Quiz tells a correct answer whenever you type a bare 
new-line. At the end of input, upon interrupt, or when 
questions run out, gutz reports a score and terminates. 


The —t flag specifies ‘‘tutorial’? mode, where missed 
questions are repeated later, and material is gradually 
introduced as you learn. 


The —i flag causes the named file to be substituted for 
the default index file. The lines of these files have the 
syntax: 


line = category new-line | category : line 
category = alternate | category | alternate 
alternate — empty | alternate primary 
primary = character | [ category ] | option 
option = { category } 


The first category on each line of an index file names an 
information file. The remaining categories specify the 
order and contents of the data in each line of the 
information file. Information files have the same syntax. 
Backslash \ is used as with sh(1) to quote syntactically 
significant characters or to insert transparent new-lines 
into a line. When either a question or its answer is 
empty, qutz will refrain from asking it. 


/usr/games/lib/quiz/index 
/usr/games/lib/quiz/* 


The construct ‘‘a] ab’? does not work in an information 


file. Use “a{b}”’. 
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NAME 
trk — trekkie game 


SYNOPSIS 
/usr/games/trk [ | —a | file | 


DESCRIPTION 
Trk is a game of space glory and war. Below is a 


summary of commands. For complete documentation, 
see Trek by Eric Allman. 


If a filename is given, a log of the game is written onto 
that file. If the —a flag is given before the filename, 
that file is appended to, not truncated. 


The game will ask you what length game you would like. 
Valid responses are ‘‘short”, ‘“‘medium’’, and ‘“‘long”’. 
You may also type ‘‘restart”’, which restarts a previously 
saved game. You will then be prompted for the skill, to 
which you must respond “novice”, ‘fair’, ‘‘good”’, 
“expert”’, ‘“commadore’’, or “‘impossible”’. You should 
normally start out as a novice and work up. 


In general, throughout the game, if you forget what is 
appropriate, the game will tell you what it expects if you 
just type in a question mark. 


COMMAND SUMMARY 
abandon 
capture 
cloak up/down 
computer request; ... 
damages 
destruct 
dock 
help 
impulse course distance 
Irscan 
move course distance 
phasers automatic amount 
phasers manual amtl coursel spread] ... 
torpedo course [yes] angle/no 
ram course distance 
rest time 
shell 
shields up/down 
srscan [yes/no] 
status 
terminate [yes/no] 
undock 
visual course 
warp warp_factor 
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NAME 
ttt, cubic — tic-tac-toe 

SYNOPSIS 
/usr/games/ttt 
/usr/games/cubic 

DESCRIPTION 
Ttt is the X and O game popular in the first grade. This 
is a learning program that never makes the same mistake 
twice. 
Although it learns, it learns slowly. It must lose nearly 
80 games to completely know the game. 
Cubte plays three-dimensional tic-tac-toe on a 4x4xX4 
board. Moves are specified as a sequence of three 
coordinate numbers in the range 1-4. 

FILES 
/usr/games/ttt.k learning file 
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NAME 
wump — the game of hunt-the-wumpus 

SYNOPSIS 
/usr/games/wump 

DESCRIPTION 
Wump plays the game of “Hunt the Wumpus.” A 
Wumpus is a creature that lives in a cave with several 
rooms connected by tunnels. You wander among the 
rooms, trying to shoot the Wumpus with an arrow, 
meanwhile avoiding being eaten by the Wumpus and 
falling into Bottomless Pits. There are also Super Bats 
which are likely to pick you up and drop you in some 
random room. 
The program asks various questions which you answer 
one per line; it will give a more detailed description if 
you want. 
This program is based on one described in People’s 
Computer Company, 2, 2 (November 1973). 

BUGS 


It will never replace Adventure. 


NAME 


INTRO (7) 


intro — introduction to special files 


SYNOPSIS 


#include <sys/socket.h> 

/* internetworking only */ 
#include <net/route.h> 
#include <net/if-h> 


DESCRIPTION 


This section describes various special files that refer to 
specific hardware peripherals and CTIX System device 
drivers. The names of the entries are generally derived 
from names for the hardware, as opposed to the names of 
the special files themselves. Characteristics of both the 
hardware device and the corresponding CTIX system 
device driver are discussed where applicable. 


INTERNETWORKING 
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Entries that describe network protocol use are marked 
(7N). These protocols are available only with a special 
version of the CTIX. kernel that supports 
internetworking. For further information, see the CTLXY 
Inernetworking Manual. 


All network protocols are associated with a specific 
protocol-family. A protocol-family provides basic 
services to the protocol implementation to allow it to 
function within a specific network environment. These 
services may include packet fragmentation and 
reassembly, routing, addressing, and basic transport. A 
protocol-family may support multiple methods of 
addressing, though the current protocol implementations 
do not. A protocol-family is normally comprised of a 
number of protocols, one per socket(2N) type. It is not 
required that a protocol-family support all socket types. 
A protocol-family may contain multiple protocols 
supporting the same socket abstraction. 


A protocol supports one of the socket abstractions 
detailed in socket(2N). A specific protocol may be 
accessed either by creating a socket of the appropriate 
type and protocol-family, or by requesting the protocol 
explicitly when creating a socket. Protocols normally 
accept only one type of address format, usually 
determined by the addressing structure inherent in the 
design of the  protocol-family/network architecture. 
Certain semantics of the basic socket abstractions are 
protocol specific. All protocols are expected to support 
the basic model for their particular socket type, but 
may, in addition, provide non-standard facilities or 
extensions to a mechanism. For example, a protocol 


a 
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supporting the SOCK_STREAM abstraction may allow 
more than one byte of out-of-band data to be 
transmitted per out-of-band message. 


A network interface is similar to a device interface. 
Network interfaces comprise the lowest layer of the 
networking subsystem, interacting with the actual 
transport hardware. An interface may support one or 
more protocol families and/or address formats. The 
SYNOPSIS section of each network interface entry gives 
a sample specification of the related drivers for use in 
providing a system description to the config(1M) 
program. The DIAGNOSTICS section lists messages 
which may appear on the console and in the system error 
log /usr/adm/messages due to errors in device 
operation. 


PROTOCOLS 


The system currently supports only the DARPA Internet 
protocols fully. Raw socket interfaces are provided to IP 
protocol layer of the DARPA Internet, to the IMP link 
layer (1822), and to Xerox PUP-1 layer operating on top 
of 3Mb/s Ethernet interfaces. Consult the appropriate 
manual pages in this section for more information 
regarding the support for each protocol family. 


ADDRESSING 


Associated with each protocol family is an address 
format. The following address format is supported: 


#define AF_INET 2 
/* internetwork: UDP, TCP, etc. */ 


ROUTING 
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The network facilities provide limited packet routing. A 
simple set of data structures comprise a “‘routing table”’ 
used in selecting the appropriate network interface when 
transmitting packets. This table contains a single entry 
for each route to a specific network or host. A user 
process, the routing demon, maintains this data base 
with the aid of two socket specific toctl(2) commands, 
SIOCADDRT and SIOCDELRT. The commands allow 
the addition and deletion of a single routing table entry, 
respectively. Routing table manipulations may only be 
carried out by the superuser. 


A routing table entry has the following form, as defined 
in <net/route.h>: 
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struct rtentry { 
u_long rt_hash; 
struct sockaddr rt_dst; 


struct sockaddr rt_gateway; 
short rt_flags; 

short rt_refent; 

u_long rt_use; 

struct ifnet *rt_ifp; 


}; 
with rt_flags defined from, 
#define RTF_UP Oxl 


* route usable * 
#define RTF_GATEWAY 0x2 
/* destination is a gateway */ 
#define RTF_HOST 0x4 
/* host entry (net otherwise) */ 


Routing table entries come in three types: for a specific 
host, for all hosts on a specific network, for any 
destination not matched by entries of the first two types 
(a wildcard route). When the system is booted, each 
network interface that is autoconfigured installs a 
routing table entry when it wishes to have packets sent 
through it. Normally the interface specifies the route 
through it is a ‘direct’? connection to the destination 
host or network. If the route is direct, the transport 
layer of a protocol family usually requests the packet be 
sent to the same host specified in the packet. Otherwise, 
the interface may be requested to address the packet to 
an entity different from the eventual recipient (i.e., the 
packet is forwarded). 


Routing table entries installed by a user process may not 
specify the hash, reference count, use, or interface fields; 
these are filled in by the routing routines. If a route is 
in use when it is deleted (rt_refent is nonzero), the 
resources associated with it will not be reclaimed until 
further references to it are released. 


The routing code returns EEXIST if requested to 
duplicate an existing entry, ESRCH if requested to delete 
a nonexistant entry, or ENOBUFS if insufficient 
resources were available to install a new route. 


User processes read the routing tables through the 
/dev/kmem device. 


The rt_use field contains the number of packets sent 
along the route. This value is used to select among 
multiple routes to the same destination. When multiple 
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routes to the same destination exist, the least used route 
is selected. 


A wildcard routing entry is specified with a zero 
destination address value. Wildcard routes are used only 
when the system fails to find a route to the destination 
host and network. The combination of wildcard routes 
and routing redirects can provide an economical 
mechanism for routing traffic. 


INTERFACES 
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Each network interface in a system corresponds to a 
path through which messages may be sent and received. 
A network interface usually has a hardware device 
associated with it. 


At boot time each interface which has underlying 
hardware support makes itself known to the system 
during the autoconfiguration process. Once the interface 
has acquired its address, it is expected to install a 
routing table entry so that messages may be routed 
through it. Most interfaces require some part of their 
address specified with an SIOCSIFADDR ioctl before 
they will allow traffic to flow through them. On 
interfaces where the network-link layer address mapping 
is static, only the network number is taken from the 
ioctl; the remainder is found in a hardware-specific 
manner. On interfaces which provide dynamic network- 
link layer address mapping facilities (e.g. 10Mb/s 
ie the entire address specified in the ioctl is 
used. 


The following toctl calls may be used to manipulate 
network interfaces. Unless specified otherwise, the 
request takes an tfrequest structure as its parameter. 
This structure has the form 


struct ifreq { 
char _ifr_name(16]; 
/* name of interface (e.g. "ec0”) */ 
union { 
struct sockaddr ifru_addr; 
struct sockaddr ifru_dstaddr; 
short ifru_flags; 
ifr_ifru; 
#defineifr_addrifr_ifru.ifru_addr 
ie address */ 
#define ifr_dstaddr ifr_ifru.ifru_dstaddr 
/* other end of p-to-p link */ 
#define ifr_flagsifr_ifru.ifru_flags 
/* flags */ 
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SIOCSIFADDR 
Set interface address. Following the address 
assignment, the “‘initialization” routine for the 
interface is called. 


SIOCGIFADDR 


Get interface address. 


SIOCSIFDSTADDR 


Set point-to-point address for interface. 


SIOCGIFDSTADDR 


Get point-to-point address for interface. 


SIOCSIFFLAGS 
Set interface flags field. If the interface is 
marked down, any processes currently routing 
packets through the interface are notified. 


SIOCGIFFLAGS 
Get interface flags. 


SIOCGIFCONF 
Get interface configuration list. This request 
takes an ifconf structure (see below) as a value- 
result parameter. The ifc_len field should be 
initially set to the size of the buffer pointed to 
by tfe_buf. On return it will contain the length, 
in bytes, of the configuration list. 

* 


* Structure used in SIOCGIFCONF request. 
* Used to retrieve interface configuration 

* for machine (useful for programs which 
must know all networks accessible). 


struct ifconf { 
int ifc_len; 
/* size of associated buffer */ 
union { 
caddr_t ifcu_buf; 
struct ifreq *ifcu_req; 
ifce_ifcu; 
#define ifc_buf ifc_ifcu.ifeu_buf 
/* buffer address */ 
#define ifc_req ifc_ifcu.ifcu_req 
; * array of structures returned */ 


SEE ALSO 


config(1M), ioctl(2), socket(2N), intro(7). 


NAME 


CONSOLE(7) 


console — console terminal 


DESCRIPTION 
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The special file /dev/console designates a standard 
destination for system diagnostics. The kernel writes its 
diagnostics to this file, as does any user process with 
messages of systemwide importance. Unless CTIX is 
configured with the kernel debugger, console is not 
associated with a terminal; console messages are written 
to /etc/log/confile. If console is associated with a 
physical terminal (configured with the kernel debugger), 
then console messages appear on that terminal. 


Note that inittab(4) does not normally post a getty on 
console because it has no source for interactive input. 


Console messages are saved in a circular buffer. Reading 
console retrieves the messages and removes them from 
the buffer. 


If CTIX is configured with the kernel debugger (see 
config(1M)), then tty000 is associated with the console. 
This means that console messages also go to tty000 and 
that a Control-B on tty000 starts the kernel debugger. 


The size of the console circular buffer is configured with 
the config(1M) parameter cbufsz. The default is 4096 
bytes. 


The following toctl(2) commands are acceptd: 


ioctl(fd, CONERR); 
d must be open to console. All console output 
is to be duplicated in the error message queue. 
See err (7). 
ioctl(fd, CONBUF); 
Fd must be open to console. No console output 
is to be duplicated in the error message queue. 
This is the initial condition. 


ioctl(fd, CON_SET, port) 
Fd must be open to console. Port is the minor 
device number of the RS-232 line that will be 
the new debugger console; port must be a valid 
RS-232 channel. The function returns the 
number of the new debugger console port. 
ioctl(fd, CON_LOC) 
Fd must be open to console. The function 
returns the number of the current debugger 
console port. 
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FILES 
/dev/console 
/etc/log/confile 


SEE ALSO 
conlocate({1M), syslocal(2). 


WARNING 
Normal system processing is suspended while the kernel 
debugger is active. 
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NAME 


DISK (7) 


disk — general disk driver 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/gdisk.h> 
#include <sys/gdioctl.h> 


DESCRIPTION 
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The files 

/ dev /rdsk/c0d0s0 

through 

/dev/rdsk/crdrsz 

and 

/dev /dsk/c0d0sO 

through 

/dev/dsk/erdzrsz 

refer to CTIX device names and slices, where cz is the 
controller number, dz is the drive number, sz is the slice 
number, and z is a hexadecimal digit. An r in the 
name indicates the character (raw) interface, 


MightyFrame and MiniFrame format a disk with 512- 
byte physical sectors. Winchester disks have 17 physical 
sectors per track. SMD drives have 33 to 65 physical 
sectors per track. 


Block input/output uses 1024-byte logical blocks. 
Winchester disks have 8 logical blocks on each track, 
with the leftover physical block available as an alternate 
for a bad block. SMD disks have 16 to 32 logical blocks 
on each track, with the leftover physical block available 
as an alternate for a bad block. 


Logical block zero contains the Volume Home Block, 
which describes the disk. The following structure defines 
the volume home block. 


struct vhbd { 


uint magic; /* Mitiframe disk format code */ 

int chksum; /* adjustment so 32 bit sum starting 
from magic for 1K bytes sums to —1 */ 

struct gdswprt dsk; /* specific description of this disk */ 

struct partit partab[MAXSLICE];/* partition table */ 

struct resdes{ /* reserved area special files */ 


daddr_t blkstart; /* start logical block # */ 
ushort nblocks; /* length in logical blocks 
(zero implies not present) */ 


} resmap|8]; 
/* resmap consists of the following entries: 
- loader area 
> bad block table 
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dump area 


char fpulled; 
long time; 
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down load image file 
Bootable program, 
size determined by a.out format. nblocks=1. 


/* dismounted last time? */ 
/* time last came on line */ 


struct gdswprt2 dsk2; /* Drive specific parameters */ 


char minires|38}; 


char sysres(292]; 


/* for future mini/miti frame 
enhancements */ 
/* custom system area */ 


struct mntnam mntname|MA XSLICE]; 


char userres([256]; 


} 


struct gdswprt { 
char name(6}; 
ushort cyls; 
ushort heads; 
ushort psectrk; 
ushort pseccyl; 


char flags; 
char step; 
ushort sectorsz; 


}; 


struct gdswprt2 { 
short wpccyl; 


ushort enetaddr(3]; 


unchar gapl; 
unchar gap2; 
char _filler(28]; 


struct partit{ 
union { 
uint strk; 
struct { 


/* names for auto mounting; null 
* string means no auto mount 

* not used in mitiframe */ 

/* user area */ 


/* printf name */ 
/* the number of cylinders for this disk */ 
/* number of heads per cylinder */ 
/* number of physical sectors per track */ 
/* number of physical sectors per cylinder */ 
/* floppy density and high tech drive flags */ 
/* stepper motor rate to controller - 
ST506 only */ 
/* size of physical sectors (in bytes) */ 


/* value to program for RWC/WPC - 
ST506 only */ 

/* Ethernet station address —- 

* MiniFrame only */ 

/* Gap size on SMD drives */ 


/* start track number (new style) */ 


ushort strk; /* start track # */ 
ushort nsecs; /* # logical blocks available to user */ 


} old; 
} sz; 
hi 
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If a volume home block is valid, magic is equal to 
VHBMAGIC and the 32-bit sum of the volume home 
block’s bytes is OxFFFFFFFF (-1); chksum is the 
adjustment that makes the sum come out right. 


Dsk describes the peculiarities of the disk, including 
deliberate deviations from the system standard. 
Dsk.flags the bitwise or of zero or more of the following 
constants: 


FPDENSITY (MiniFrame only) If on, the 
disk is double density; if 
off, the disk is single 
density. 

FPMIXDENS (MiniFrame only) If off, 
FPDENSITY specifies the 
density of the first track; if 
on, the first track is single 


density regardless of 
FPDENSITY. 
HITECH (ST506 only) If on, head 


select bit 3 is valid; if off, 
reduced write current is 
valid. 


NEWPARTTAB If off, the old style slice 
(partition) table is in use; if 
on, the new style slice table 


is in use. 

RWCPWC (ST506 only) If on, set 
reduced write current/write 
precompensation. 
HITECH selects’ write 
precompensation. 

EXCHANGEABLE If on, the disk is a floppy 


or removable hard disk 
cartridge. If off, the disk is 
a winchester. 


FORMATEXTRA If on, the SMD drive is 
formatted with an extra 
sector on each track. (This 
sector is ignored by CTIX 
but is required for some 
disk drives, notably the 
Eagle-XP.) 


Dsk.step specifies a stepper motor rate for the ST506; 
use 14 in this field. 
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Partab divides the disk into slices (partitions). 


Fpulled indicates whether an exchangeable disk was 
properly removed from the drive. The system sects this 
field to 1 when the disk is inserted in the drive. To clear 
fpulled, run dismount(1M); see that entry. 


Mnitname, minires, and userres are reserved for future 
use. 


Resmap describes the files that share Slice 0 with the 
Volume Home Block. Provision is made for eight such 
files, but only five have been assigned slots in resmap. 
Each resmap entry gives the starting location (logical 
block number) and length (logical blocks). A length of 
zero indicates that the file is not provided. The first five 
entries in resmap describe: 


1. The loader. When the system is reset or turned 
on, the boot prom loads the loader into the 
loader address and jumps execution to it. The 
function of the loader is to search for and load a 
program that will boot the system. 


On MightyFrame the loader searches the tape, 
onboard Winchester disks 0, 1, and 2, and the 
VME, in that order. On MiniFrame the loader 
searches the tape, the floppy disk, and 
Winchester disks 1 and 0, in that order. 


On each disk, the loader first checks for a 
standalone program. If the disk lacks a 
standalone program, the loader checks for a 
CTIX kernel, which must be a CTIX executable 
object file called /unix in the file system in slice 
1. When the loader locates an appropriate 
program, it preserves the crash dump table, 
loads the program it found at the address it was 
linked at (0x0 if unknown) and executes it. If no 
disk contains an appropriate file, the loader 
continues searching until an appropriate disk is 
inserted. 


2: The bad block table, which always begins at 
logical block 1 of the disk. Each logical block in 
the bad block table consists of a four-byte 
checksum followed by 127 bad block cells. The 
checksum is a value that makes the 32-bit sum 
of the logical block be OxFFFFFFFF (-1). A 
bad block cell is defined by the following 
structure. 
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struct bbcell { 
ushort cyl; /* the cylinder of the bad block */ 
ushort badblk; /* the physical sector address of 
the bad block within the cylinder cyl */ 
ushort altblk; /* track number of alternate */ 
ushort nxtind; /* index into the cell array for next 
bad block cell for this cylinder */ 
}; 
A single sequence of numbers, starting from zero, 
identifies the checksums and cells. In each cell 
in use, cyl identifies a cylinder that contains the 
bad block; badblk physical block offset within 
the cylinder of the bad block; altblk identifies 
the track that contains the alternate block; 
neztind (not used in MightyFrame) identifies the 
next cell for a bad block on the same cylinder or 
is zero if this is the last one. 


The dump area. After Reset or Suicide, the 
Boot prom dumps processor registers, the 
memory map, a crash dump block, and the 
contents of physical memory, until it runs out of 
room in the dump area. 


The down load image area. The down load 
images are described by a table at the beginning 
of the area. The area is described by the 
following array. 


struct dident { 

short d_strt; 

/* block displacement from down load index */ 

short d_sz; 

/* # of blocks for this entry */ 
The image number is the index for dident. 
D_strt is the offset in bytes of the image from 
the beginning of the down load image area; d_sz 
is the size in bytes of the image. 


A bootable program, usually a diagnostic. This 
is the program the loader considers a substitute 
for the /unix file. The program must be in 
a.out(4) format with magic number 407 or be a 
simple memory image. 


If the fifth entry in resmap has a zero address 
but a nonzero length, the loader looks at the 
beginning of slice 1 for the program. 
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Slice 0 is called the Reserved Area. Only the volume 
home block and the files described by resmap can be in 
the Reserved Area. A formatted disk used by a working 
system certainly has at least one more slice. 


Toctl system calls use the following structure. 
struct gdioctl { 


ushort status; /* status */ 

struct gdswprt params; /* description of the disk */ 
struct gdswprt2 params2; /* more description of the disk */ 
short ctrltyp; /* the type of disk controller */ 


short driveno; 
hi 
Status is the bitwise or of the following constants. 
VALID_VHB_ A valid Volume Header Block has been 


read. 
DRV_READY The disk is on line. 
PULLED Last removal of disk from drive was not 


preceded by proper dismount. 


Params is a gdswprt structure, the same type used in the 
volume header block. 


Dsktype is equal to 
GD_WD1010 for Western Digital 1010 ST506 


Controller 

GD_WD2010 for Western Digital 2010 ST506 
Controller 

GD_WD2797 for Western Digital 2797 Floppy Disk 
Controller 


GD_RAMDISK for RAM Disk Emulator 
GD_SMD3200 for Interphase SMD3200 disk controller 
CTIX understands the following disk toctl calls. 


ioctl(fd, GDIOCTYPE, 0) 
Returns GDIOC if fd is a file descriptor for a 
disk special file. 


ioctl(fd, GDGETA, gdctl_ptr) 
Gdctl_ptr is a pointer to a gdioctl structure. 


Toctl fills the structure with information about 
the disk. 


ioctl(fd, GDSETA, gdetl_ptr) 
Gdctl_ptr is a pointer to a gdioctl structure. 
Ioctl passes the description of the disk to the 
disk driver. This is primarily meant for reading 
disks created by other kinds of computers. 
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ioctl(fd, GDFORMAT, ptr) 


Ptr points to formating information. The disk 
driver formats a track. 


ioctl(fd, GDDISMNT) 


SEE ALSO 


Toctl informs the driver that the user intends to 
remove the disk from the drive. When this 
system call successfully returns, the driver has 
flushed all data in the buffer cache and waited 
for all queued transfers to complete. The last 
transfer is to write out the Volume Home Block 
with the fpulled flag cleared. Once this call 
returns the drive is inaccessible until a new disk 
is inserted. 


iv(1), mknod(1M), ioctl(2). 
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NAME 
drivers — loadable device drivers 

DESCRIPTION 
A loadable driver is equivalent to a fixed, linked-in 
device driver. It has access to all kernel subroutines and 
global data. After it is loaded, it is effectively part of 
the running kernel. 
Differences between loadable and ordinary drivers 
involve their driver ID, init routine, release routine, and 
interrupt processing. 

Init Routine 


Loadable drivers may have an init routine that is 
executed when the driver is bound, and a release routine 
that is executed when the driver is unbound (sce 
lddrv(1M) for a description of driver allocation and bind 
operations). Init routines check for the existence of 
hardware, initialize the hardware, put the interrupt 
service routine for the hardware into the interrupt chain, 
and do other similar tasks. 


Release Routine 


Release routines make sure the device or driver is idle, 
turn off the device, take the interrupt service routine out 
of the interrupt chain, and similar tasks. A typical action 
for a release routine to take when the device zs not idle is 
to set an error code in u.u_error and return. 


Driver ID 


All drivers have a driver ID. Preloaded drivers have a 
driver ID of 0. Loaded drivers are given an ID when 
they allocate virtual space. The driver ID is 
automatically set when the driver is linked. The ID 
should never be modified by the driver itself; the ID is 
used to identify the driver to the system when making 
certain requests. 


EXAMPLE 


/* init, release, interrupt service routines */ 
/* for loadable device xyzzy */ 


#include <sys/drv.h> 


#define XYZ_VECNO 0x60 /* interrupt vector number */ 
#define XYZ_BUSY i /* flags */ 

#define XYZ_OPEN 2 

int xyzzint(); /* interrupt service routine */ 
extern int DFLT_ID; 

static int Drv_id = &DFLT_ID; /* set drive ID */ 

int xy_base; 

int xy_flags; 
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xy_init() 
{ 
if (set_vec(Drv_id, XYZ_VECNO, xyzzyint) < 0) 
{ 
u.u_error = EBUSY; 
return; 


<do hardware initialization > 


xy_release(} 


{ 
if (xy_flags & (XKY_BUSY | XY_OPEN)) 
{ 
u.u_error = EBUSY; 
return; 
} 
<turn off device> 
reset_vec (Drv_id, XYZ_VECNO); 
} 
xyzzyint() 
{ 
<clear interrupt > 
< process interrupt > 
} 
SEE ALSO 


Writing MightyFrame Device Drivers. 
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err — error-logging interface 


DESCRIPTION 


FILES 


Minor device 0 of the err driver is the interface between 
a process and the system’s error-record collection 
routines. The driver may be opened only for reading by 
a single process with super-user permissions. Each read 
causes an entire error record to be retrieved and 
removed; the record is truncated if the read request is for 
less than the record’s length. 


An appropriate command to the console sends console 
information to the error record queue. See console(7). 


/dev/error special file 


SEE ALSO 


errdemon(1M), console(7). 
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Ip — parallel printer interface 


DESCRIPTION 


Lp is an interface to the parallel printer channel. Bytes 
written are sent to the printer. Opening and closing 
roduce page ejects. nlike the serial interfaces 
termio(7)}, the (ip driver never prepends a carriage 
return to a new line (line feed). The /p driver does have 
options to filter output, for the benefit of printers with 
special requirement. The driver also controls page 
format. Page format and filter options are controlled 
with toctl(2): 

#include <sys/Iprio.h> 

ioctl(fildes, command, arg) 


where command is one of the following constants: 


LPRGET Get the current page format and put it 
in the Iprio structure pointed to by 
arg. 

LPRSET Set the current page format from the 


location pointed to by arg; this location 
is a structure of type Iprio, declared in 


the header file: 
struct Iprio { 
short ind; 
short col; 
short line; 


Arg should be declared as follows: 
struct Iprio *arg; 


Ind is the page indent in columns, 
initially 4. Col is the number of 
columns in a line, initially 132, Line is 
the number lines on a page, initially 66. 
A newline that extends over the end of 
a page is output as a formfeed. Lines 
longer than the line length minus the 
indent are truncated. 


LPRSOPTS 
Constant Value 
LPNOBS 4 
LPRAW 8 
LPCAP 16 
LPNOCR 32 
LPNOFF 64 
LPNONL 128 
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Set the filter options from arg, which 
must be of type int. Arg should be the 
logical or of one or more of the 
following constants, defined in the 
header file: 

Meaning 


No back space. Set this bit if the 
printer cannot properly interpret 
backspace characters. The driver uses 
carriage return to produce equivalent 
overstriking. 


Raw output. Set this bit if the driver 
must not edit output in any way. The 
driver ignores all other option bits. 


Capitals. This option supports printers 
with a ‘“‘half-ASCII’’ character set. 
Lowercase is translated to uppercase. 
The following special characters are 
translated: { to {, } to }; * to -; | to 
+; to -. 

No Carriage Return. This option 
supports printers that do not respond to 
a carriage return (character OD 
hexadecimal). Carriage returns are 
changed to newlines. If No Newline is 
also set, carriage returns are changed to 
form feeds. 


No Form Feed. This option supports 
printers that do not respond to a form 
feed (character OC hexadecimal). Form 
Feeds are changed to newlines. If No 
Newline is also set, form feeds are 
changed to carriage returns. 


No Newline. This option supports 
printers that do not respond to a 
newline (character OA _ hexadecimal). 
Newlines are changed to carriage 
returns. If No Carriage Return is also 
set, newlines are changed to form feeds. 


Setting all three of No Carriage Return, No New Line, 
and No Form Feed has the same effect as setting none of 


them. 


LPRGOPTS 


Return the current state of the filter 
options. 
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Note that once set, options will remain intact through a 
close. 
FILES 
/dev/\p? 
SEE ALSO 
Ipr(1), lpset(1). 
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NAME 
mem, kmem — system memory interface 


DESCRIPTION 
Mem is a special file that is an image of the system 
memory. It may be used, for example, to examine, and 
even to patch the system. 


Byte addresses in mem are interpreted as memory 
addresses. References to non-existent locations cause 
errors to be returned. 


Examining and patching device registers is likely to lead 
to unexpected results when read-only or write-only bits 
are present. 


The file kmem is the same as mem except that kernel 
virtual memory rather than physical memory is accessed. 


On the MightyFrame system accessing 0 to 24 megabytes 
allows a process to read its own space. Ox7F800000 to 
0x80000000 allows a process to read the kernel. 
Nonvalid pages cause errors to be returned. 


SEE ALSO 
vme(7). 
FILES 
/dev/mem 
/dev/kmem 
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NAME 
null — the null file 


DESCRIPTION 
Data written on a null special file is discarded. 
Reads from a null special file always return 0 bytes. 


FILES 
/dev/null 


NAME 


PRF(7) 


prf — operating system profiler 


DESCRIPTION 


FILES 


The file prf provides access to activity information in 
the operating system. Writing the file loads the 
measurement facility with text addresses to be 
monitored. Reading the file returns these addresses and 
a set of counters indicative of activity between adjacent 
text addresses. 


The recording mechanism is driven by the system clock 
and samples the program counter at line frequency. 
Samples that catch the operating system are matched 
against the stored text addresses and increment 
corresponding counters for later processing. 


The file prf is a pseudo-device with no associated 
hardware. 


/dev/prf 


SEE ALSO 


config(1M), profiler(1M). 
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qic — interface for QIC tape 


DESCRIPTION 


This interface provides access to quarter-inch streaming 
tape (QIC). QIC tape drives are supported only as 
character devices. If the system has a default tape 
device (such as the QIC on a MightyFrame system), the 
rmtO and rmt4 devices exist and are linked to the 
appropriate real device names. To get the raw, rewind 
on close device, use rmtO. To get the raw, no-rewind on 
close device, use rmt4. 


Tape files are separated by tape marks, also known as 
EOFs. Closing a file open for writing writes one tape 
mark; if the device was no-rewind, the tape is left 
positioned just after the single QIC tape mark. Note 
that it is not possible to overwrite a tape mark. Writing 
must begin either at the beginning of the tape or after 
any previously recorded data. 


Each read or wrtte reads or writes the next physical 
block. A read must match the size of a normal tape 
block. The size of a write determines the size of the next 
block; Write sizes must be a multiple of 512. 
Read/write buffers must begin on an even address; this 
is the same alignment as short. Seeks are ignored. 
Reading a tape mark produces a zero-length read and 
leaves the tape positioned after the mark; the program 
can, without closing the device, read the next tape file. 


The following commands are supported for QIC tape via 
toctl(2): 


#include <sys/tsioctl.h> 
ioctl (fildes, cmd, arg) 


where emd is one of the following: 


TPGETA Get the current status of the tape 
controller. Arg must be a pointer to a 
tpto struction defined as follows: 


struct tpio { 
unsigned status; 
} short under; 
TPCMD Specify a command to the tape 
controller as specified in arg. The 
following are legal values of arg: 


TPIOCTYPE 


FILES 
/dev/rmt? 
/dev/rqic/* 
WARNING 
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SENSE Perform a read tape status. 
The result may be read via 
TPGETA. 

TRESET Reset the tape controller. 

REWIND 
Issue a rewind command. 

ERASE Issue an erase tape command. 

RETEN Issue a_ retension tape 
command. 


Return TPIOC if fildes is a file 
descriptor for a tape special file. 


A nondata error cannot be recovered from except by 
closing the device. 


A QIC tape has no special mark for end of tape, as 
opposed to end of file. 
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sxt — pseudo-device driver 


DESCRIPTION 


Szt is a pseudo-device driver that interposes a discipline 
between the standard tty line disciplines and a real 
device driver. The standard disciplines manipulate 
virtual tty structures (channels) declared by the szt 
driver. Szt acts as a discipline manipulating a real tty 
structure declared by a real device driver. The szt driver 
is currently only used by the sh/ (1) command. 


Virtual ttys are named by inodes in the subdirectory 
/dev /sxt and are allocated in groups of up to eight. To 
allocate a group, a program should exclusively open a file 
with a name of the form /dev/sxt/??0 (channel 0) and 
then execute a SXTIOCLINK foctl call to initiate the 
multiplexing. 


Only one channel, the controlling channel, can receive 
input from the keyboard at a time; others attempting to 
read will be blocked. 


There are two groups of toctl(2) commands supported by 
szt. The first group contains the standard toctl 
commands described in termto(7), with the addition of 
the following: 


TIOCEXCL Set exclusive use mode: no further opens are 

permitted until the file has been closed. 

TIOCNXCL Reset ezclusive use mode: further opens are 

once again permitted. 

The second group are directives to szt itself. Some of 

these may only be executed on channel 0. 

SXTIOCLINK Allocate a channel group and multiplex 
the virtual ttys onto the real tty. The 
argument is the number of channels to 
allocate. This command may only be 
executed on channel 0. Possible errors 
include: 

EINVAL ‘The argument is out of 
range. 


ENOTTY The command was not 
issued from a real tty. 


ENXIO linesw is not configured 
with szt. 


EBUSY An SXTIOCLINK 
command has already 
been issued for this real 


SXTIOCSWTCH 


SXTIOCWF 


SXTIOCUBLK 


SXTIOCSTAT 


SXTIOCTRACE 


SXTIOCNOTRACE 


FILES 
/dev/sxt/??/0-7] 


/usr/include/sys/sxt.h 


SEE ALSO 
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tly. 


There is no system 
memory available for 
allocating the virtual tty 
structures. 


Channel O- was_ not 
opened before this call. 


ENOMEM 


EBADF 


Set the controlling channel. Possible 
errors include: 


EINVAL An invalid 
number was given. 


EPERM The command was not 
executed from channel 0. 


channel 


Cause a channel to wait until it is 
the controlling channel. This 
command will return the error, 
EINVAL, if an invalid channel 
number is given. 


Turn off the loblk control flag in the 
virtual tty of the indicated channel. 
The error EINVAL will be returned 
if an invalid number or channel 0 is 
given. 


Get the status (blocked on input or 
output) of each channel and store in 
the sztblock structure referenced by 
the argument. The error EFAULT 
will be returned if the structure 
cannot be written. 


Enable tracing. Tracing information 
is written to [dee] oath. This 
command has no effect if tracing is 
not configured. 


Disable tracing. This command has 
no effect if tracing is not configured. 


Virtual tty devices 
Driver specific definitions. 


shl(1), stty(1), ioctl(2), open(2), termio(7). 
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termio — general terminal interface 


DESCRIPTION 


CTIX systems use a single interface convention for all 
RS-232 and cluster (RS-422) terminals, although cluster 
terminals do not use all the features of the convention. 
The convention is almost completely taken from the 
UNIX System V interface for asynchronous terminals. 


Three kinds of terminals use this convention: 


e RS-232 terminals connected to channels on the 
MightyFrame or MiniFrame itself. 
° Cluster terminals. Generally a cluster channel 


supports more than one terminal and some 
terminals are indirectly connected through other 
(daisy-chained) terminals. Cluster terminals use 
the same interface as directly connected RS-232 
terminals, except that hardware control 
Operations are meaningless on cluster terminals. 
(Note that ‘cluster terminal” refers to the way 
the terminal is used, not to the terminal itself; a 
Convergent Technologies terminal can serve as 
an RS-232 terminal or as a cluster terminal.) 


° Local RS-232 terminals. These are connected to 
RS-232 channels on cluster terminals. They 
actually use the cluster terminal’s RS-422 
channel to communicate with the host computer 
system, but work like regular RS-232 terminals. 


A single naming convention applies to regular RS-232 
and cluster terminals; a second, related, convention 
applies to local RS-232 terminals. A direct RS-232 or 
cluster terminal has a name of the form /dev/ttyzzz, 
where zzz is the terminal’s number expressed in three 
digits. A local RS-232 terminal has a name of the form 
/dev/tp/czrz where ¢ is the RS-232 channel number (a 
or b), and zzz is the accomodating cluster terminal’s 
terminal number expressed in three digits. A local RS- 
232 terminal cannot be opened prior to the first open on 
the associated RS-422 terminal since the last reboot of 
the system. 


When a terminal file is opened, it normally causes the 
process to wait until a connection is established. In 
practice, users’ programs seldom open these files; they 
are opened by getty and become a user’s standard input, 
output, and error files. The very first terminal file 
opened by the process group leader of a terminal file not 
already associated with a process group becomes the 


a 
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control terminal for that process group. The control 
terminal plays a special role in handling quit and 
interrupt signals, as discussed below. The control 
terminal is inherited by a child process during a fork(2). 
A process can break this association by changing its 
process group using setpgrp(2). 


A terminal associated with one of these files ordinarily 
operates in full-duplex mode. Characters may be typed 
at any time, even while output is occurring, and are only 
lost when the system’s character input buffers become 
completely full, which is rare, or when the user has 
accumulated the maximum allowed number of input 
characters that have not yet been read by some program. 
Currently, this limit is 256 characters. When the input 
limit is reached, all the saved characters are thrown 
away without notice. 


Normally, terminal input is processed in units of lines. 
A line is delimited by a newline (ASCII LF) character, an 
end-of-file (ASCII EOT) character, or an end-of-line 
character. This means that a program attempting to 
read will be suspended until an entire line has been 
typed. Also, no matter how many characters are 
requested in the read call, at most one line will be 
returned. It is not, however, necessary to read a whole 
line at once; any number of characters may be requested 
in a read, even one, without losing information. 


During input, erase and kill processing is normally done. 
By default, the character generated by a Programmable 
Terminal BACK SPACE key (ASCII BS, Control-H on 
most terminals) erases the last character typed, except 
that it will not erase beyond the beginning of the line. 
By default, the character @ kills (deletes) the entire 
input line, and optionally outputs a newline character. 
Both these characters operate on a key-stroke basis, 
independently of any backspacing or tabbing that may 
have been done. Both the erase and kill characters may 
be entered literally by preceding them with the escape 
character (\). In this case the escape character is not 
read. The erase and kill characters may be changed. 


Certain characters have special functions on input. 
These functions and their default character values are 
summarized as follows: 


INTR Rubout or ASCII DEL; generated by a 
rogrammable Terminal DELETE key) 

generates an interrupt signal which is sent to 

all processes with the associated control 
terminal. Normally, each such process is 
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QUIT 


SWTCH 


ERASE 


KILL 


EOF 


NL 
EOL 


STOP 


START 
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forced to terminate, but arrangements may be 
made either to ignore the signal or to receive a 
trap to an agreed-upon location; see stgnal(2). 


Control-| or ASCII FS; generated by a 
rogrammable Terminal CODE-CANCEL key) 
generates a gutt signal. Its treatment is 
identical to the interrupt signal except that, 
unless a receiving process has made other 
arrangements, it will not only be terminated 
but a core image file (called core) will be 
created in the current working directory. 


ASCII NUL is used by the job control facility, 
shl, to change the current layer to the control 
layer. 


Control-h or ASCII BS; generated by a 
rogrammable Terminal BACKSPACE key) 
erases the preceding character. It will not 
erase beyond the start of a line, as delimited 
by a NL, EOF, or EOL character. 


(@) deletes the entire line, as delimited by a 
NL, EOF, or EOL character. 


Control-d or ASCH EOT; generated by a 
rogrammable Terminal FINISH key) may be 
used to generate an end-of-file from a terminal. 
When received, all the characters waiting to be 
read are immediately passed to the program, 
without waiting for a newline, and the EOF is 
discarded. Thus, if there are no characters 
waiting, which is to say the EOF occurred at 
the beginning of a line, zero characters will be 
passed back, which is the standard end-of-file 
indication. 


(ASCII LF) is the normal line delimiter. It can 
not be changed or escaped. 


(ASCII NUL) is an additional line delimiter, like 
NL. It is not normally used. 


(Control-s or ASCII DC3) can be used to 
temporarily suspend output. It is useful with 
CRT terminals to prevent output from 
disappearing before it can be read. While 
output is suspended, STOP characters are 
ignored and not read. 


(Control-q or ASCII DC1) is used to resume 
output which has been suspended by a STOP 
character. While output is not suspended, 
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START characters are ignored and not read. 
The start/stop characters can not be changed 
or escaped. 


The character values for INTR, QUIT, SWTCH, ERASE, 
KILL, EOF, and EOL may be changed to suit individual 
tastes. The ERASE, KILL, and EOF characters may be 
escaped by a preceding \ character, in which case no 
special function is done. 


When the carrier signal from the dataset drops, a 
hangup signal is sent to all processes that have this 
terminal as the control terminal. Unless other 
arrangements have been made, this signal causes the 
processes to terminate. If the hangup signal is ignored, 
any subsequent read returns with an_ end-of-file 
indication. Thus, programs that read a terminal and test 
for end-of-file can terminate appropriately when hung up 
on. 


When one or more characters are written, they are 
transmitted to the terminal as soon as previously-written 
characters have finished typing. Input characters are 
echoed by putting them in the output queue as they 
arrive. If a process produces characters more rapidly 
than they can be typed, it will be suspended when its 
output queue exceeds some limit. When the queue has 
drained down to some threshold, the program is resumed. 


Several toctl(2) system calls apply to terminal files. The 
primary calls use the following structure, defined in 
<termio.h>: 


#define NCC 8 

struct termio { 
unsigned short _c_iflag; /* input modes */ 
unsigned short —_c_oflag; /* output modes */ 
unsigned short c_cflag; /* control modes */ 
unsigned short —_c_Iflag; _/* local modes */ 
char c_line; /* line discipline */ 
unsigned char e_ce[NCC]; 

/* control chars */ 

The special control characters are defined by the array 

c_cc. The relative positions and initial values for each 

function are as follows: 


0 VINTR' DEL 
1 VQUIT FS 

2 VERASE BS 

3 VKILL @ 

4 VEOF EOT 
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5 VEOL NUL 
6 reserved 
7 VSWTCH NUL 


The c_tflag field describes the basic terminal input 
control: 


IGNBRK 0000001 Ignore break condition. 
BRKINT 0000002 Signal interrupt on break. 


IGNPAR 0000004 Ignore characters with parity 
errors. 


PARMRK 0000010 Mark parity errors. 

INPCK 0000020 Enable input parity check. 

ISTRIP 0000040 Strip character. 

INLCR 0000100 Map NL to CR on input. 

IGNCR 0000200 Ignore CR. 

ICRNL 0000400 Map CR to NL on input. 

IUCLC 0001000 Map upper-case to lower-case on 


input. 
IXON 0002000 Enable start/stop output control. 
IXANY 0004000 Enable any character to restart 
output. 


IXOFF 0010000 Enable start/stop input control. 


If IGNBRK is set, the break condition (a character 
framing error with data all zeros) is ignored, that is, not 
put on the input queue and therefore not read by any 
process. Otherwise if BRKINT is set, the break condition 
will generate an interrupt signal and flush both the input 
and output queues. If IGNPAR is set, characters with 
other framing and parity errors are ignored. 


If PARMRK is set, a character with a framing or parity 
error which is not ignored is read as the three-character 
sequence: 0377, 0, X, where X is the data of the 
character received in error. To avoid ambiguity in this 
case, if ISTRIP is not set, a valid character of 0377 is 
read as 0377, 0377. If PARMRK is not set, a framing or 
parity error which is not ignored is read as the character 
NUL (0). 

If INPCK is set, input parity checking is enabled. If 
INPCK is not set, input parity checking is disabled. This 
allows output parity generation without input parity 
errors. 


If ISTRIP is set, valid input characters are first stripped 
to 7-bits, otherwise all 8-bits are processed. 
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If INLCR is set, a received NL character is translated into 
a CR character. If IGNCR is set, a received CR character 
is ignored (not read). Otherwise if ICRNL is set, a 
received CR character is translated into a NL character. 


If IUCLC is set, a received upper-case alphabetic 
character is translated into the corresponding lower-case 
character. 


If IXON is set, start/stop output control is enabled. A 
received STOP character will suspend output and a 
received START character will restart output. All 
start/stop characters are ignored and not read. If IXANY 
is set, any input character, will restart output which has 
been suspended. 


If IXOFF is set, the system will transmit START/STOP 
characters when the input queue is nearly empty/full. 


The initial input control value is all-bits-clear. 


The c_oflag field specifies the system treatment of 
output: 


OPOST 0000001 Postprocess output. 

OLCUC 0000002 Map lower case to upper on output. 
ONLCR 0000004 Map NL to CR-NL on output. 
OCRNL 0000010 Map CR to NL on output. 
ONOCR 0000020 No CR output at column 0. 
ONLRET 0000040 NL performs CR function. 
OFILL 0000100 Use fill characters for delay. 
OFDEL 0000200 Fill is DEL, else NUL. 

NLDLY 0000400 Select new-line delays: 

NLO 0 

NLI1 0000400 

CRDLY 0003000 Select carriage-return delays: 
CRO 0 


CR1 0001000 
CR2 0002000 
CR3 0003000 


TABDLY 0014000 Select horizontal-tab delays: 
TABO 0 


TABI 0004000 
TAB2 0010000 
TAB3 0014000 Expand tabs to spaces. 


BSDLY 0020000 Select backspace delays: 
BSO 0 

BS1 0020000 

VTDLY 0040000 Select vertical-tab delays: 
VTO 0 

VTl 0040000 

FFDLY 0100000 Select form-feed delays: 
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FFO 0 
FF1 0100000 


If OPOST is set, output characters are post-processed as 
indicated by the remaining flags, otherwise characters 
are transmitted without change. 


If OLCUC is set, a lower-case alphabetic character is 
transmitted as the corresponding upper-case character. 
This function is often used in conjunction with IUCLC. 


If ONLCR is set, the NL character is transmitted as the 
CR-NL character pair. If OCRNL is set, the CR character 
is transmitted as the NL character. If ONOCR is set, no 
CR character is transmitted when at column 0 (first 
position). If ONLRET is set, the NL character is assumed 
to do the carriage-return function; the column pointer 
will be set to 0 and the delays specified for CR will be 
used. Otherwise the NL character is assumed to do just 
the line-feed function; the column pointer will remain 
unchanged. The column pointer is also set to 0 if the CR 
character is actually transmitted. 


The delay bits specify how long transmission stops to 
allow for mechanical or other movement when certain 
characters are sent to the terminal. In all cases a value 
of 0 indicates no delay. If OFILL is set, fill characters 
will be transmitted for delay instead of a timed delay. 
This is useful for high baud rate terminals which need 
only a minimal delay. If OFDEL is set, the fill character 
is DEL, otherwise NUL. 


If a form-feed or vertical-tab delay is specified, it lasts 
for about 2 seconds. 


new-line delay lasts about 0.10 seconds. If ONLRET is 
set, the carriage-return delays are used instead of the 
new-line delays. If OFILL is set, two fill characters will 
be transmitted. 


Carriage-return delay type 1 is dependent on the current 
column position, type 2 is about 0.10 seconds, and type 3 
is about 0.15 seconds. If OFILL is set, delay type 1 
transmits one or two fill characters, and type 2, four fill 
characters. 


Horizontal-tab delay type 1 is dependent on the current 
column position. Type 2 is about 0.10 seconds. Type 3 
specifies that tabs are to be expanded into spaces. If 
OFILL is set, two fill characters will be transmitted for 
any delay. 


Backspace delay lasts about 0.05 seconds. If OFILL is 
set, one fill character will be transmitted. 
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The actual delays depend on line speed and system load. 
The initial output control value is all bits clear. 


The c_cflag field describes the hardware control of the 
terminal: 


CBAUD 0000017 Baud rate: 

BO OHang up 

B50 000000150 baud 

B75 000000275 baud 

B110 0000003110 baud 

B134 0000004134.5 baud 

B150 0000005150 baud 

B200 0000006200 baud 

B300 0000007300 baud 

B600 0000010600 baud 

B1200 00000111200 baud 

B1800 00000121800 baud 

B2400 00000132400 baud 

B4800 00000144800 baud 

B9600 00000159600 baud 

B19200 000001619200 baud 

B38400 000001738400 baud 
CSIZE 0000060 Character size: 

CS5 05 bits 

CS6 00000206 bits 

CS7 00000407 bits 

CS8 00000608 bits 
CSTOPB 0000100 Send two stop bits, else one. 
CREAD 0000200 Enable receiver. 
PARENB 0000400 Parity enable. 
PARODD 0001000 Odd parity, else even. 
HUPCL 0002000 Hang up on last close. 
CLOCAL 0004000 Local line, else dial-up. 
LOBLK 0010000 Block layer output. 


The CBAUD bits specify the baud rate. The zero baud 
rate, BO, is used to hang up the connection. If BO is 
specified, the data-terminal-ready signal will not be 
asserted. Normally, this will disconnect the line. For 
any particular hardware, impossible speed changes are 
ignored. 

The CSIZE bits specify the character size in bits for both 
transmission and reception. This size does not include 
the parity bit, if any. If CSTOPB is set, two stop bits are 
used, otherwise one stop bit. For example, at 110 baud, 
two stops bits are required. 

If PARENB is set, parity generation and detection is 
enabled and a parity bit is added to each character. If 
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parity is enabled, the PARODD flag specifies odd parity if 
set, otherwise even parity is used. 


If CREAD is set, the receiver is enabled. Otherwise, no 
characters will be received. 


If LOBLK is set, the output of a job control layer will be 
blocked when it is not the current layer. Otherwise the 
output generated by that layer will be multiplexed onto 
the current layer. 


If HUPCL is set, the line will be disconnected when the 
last process with the line open closes it or terminates. 
That is, the data-terminal-ready signal will not be 
asserted. 


If CLOCAL is set, the line is assumed to be a local, direct 
connection with no modem control. Otherwise modem 
control is assumed. 


The initial hardware control value after open is B9600, 
CS8, CREAD, HUPCL. 


The c_Iflag field of the argument structure is used by the 
line discipline to control terminal functions. The basic 
line discipline (0) provides the following: 


ISIG 0000001 Enable signals. 

ICANON 0000002 Canonical input (erase and kill 
processing). 

XCASE 0000004 Canonical upper/lower 
presentation. 


ECHO 0000010 Enable echo. 

ECHOE 0000020 Echo erase character as BS-SP-BS. 
ECHOK 0000040 Echo NL after kill character. 
ECHONL 0000100 Echo NL. 


NOFLSH 0000200 Disable flush after interrupt or 
quit. 


If ISIG is set, each input character is checked against the 
special control characters INTR, SWTCH, and QUIT. If 
an input character matches one of these control 
characters, the function associated with that character is 
performed. If ISIG is not set, no checking is done. Thus 
these special input functions are possible only if ISIG is 
set. These functions may be disabled individually by 
changing the value of the control character to an 
unlikely or impossible value (e.g., 0377). 


If ICANON is set, canonical processing is enabled. This 
enables the erase and kill edit functions, and the 
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assembly of input characters into lines delimited by NL, 
EOF, and EOL. If ICANON is not set, read requests are 
satisfied directly from the input queue. The values of 
VMIN and VTIME control how many and when 
characters will be returned. If both are 0, reads come 
back immediately if no characters are present. If VMIN 
is greater than 0 and VTIME is equal to 0, the read will 
wait until at least VMIN characters have been received. 
If VMIN is equal to 0 and VTIME is greater than 0, the 
read will return after VTIME tenths of a second, 
regardless of whether any characters have been received. 
Note that in this case a read may return 0, which is 
indistinguishable from end-of-file. If VMIN is greater 
than O and VTIME is greater than 0, the timeout period 
starts after the first character has been received; thus a 
read will always return greater than or equal to 1. This 
allows fast bursts of input to be read efficiently while 
still allowing single character input. The MIN and TIME 
values are stored in the position for the EOF and EOL 
characters, respectively. The time value represents 
tenths of seconds. 


If XCASE is set, and if ICANON is set, an upper-case 
letter is accepted on input by preceding it with a \ 
character, and is output preceded by a \ character. In 
this mode, the following escape sequences are generated 
on output and accepted on input: 


for: use: 
a a? 


\ 
L \ 


( X 


Wt example, A is input as \a, \m as \\n, and \N as 
n. 


If ECHO is set, characters are echoed as received. 


When ICANON is set, the following echo functions are 
possible. If ECHO and ECHOE are set, the erase 
character is echoed as ASCII BS SP BS, which will clear 
the last character from a CRT screen. If ECHOE is set 
and ECHO is not set, the erase character is echoed as 
ASCII SP BS. If ECHOK is set, the NL character will be 
echoed after the kill character to emphasize that the line 
will be deleted. Note that an escape character preceding 
the erase or kill character removes any special function. 
If ECHONL is set, the NL character will be echoed even if 
ECHO is not set. This is useful for terminals set to local 
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echo (so-called half duplex). Unless escaped, the EOF 
character is not echoed. Because EOT is the default EOF 
character, this prevents terminals that respond to EOT 
from hanging up. 

If NOFLSH is set, the normal flush of the input and 
output queues associated with the quit, switch, and 
interrupt characters will not be done. 


The initial line-discipline control value is all bits clear. 
The primary toc#l(2) system calls have the form: 


ioctl (fildes, command, arg) 
struct termio *arg; 


The commands using this form are: 


TCGETA Get the parameters associated with 
the terminal and store in the 
termto structure referenced by 
arg. 

TCSETA Set the parameters associated with 
the terminal from the structure 
referenced by arg. The change is 
immediate. 


TCSETAW Wait for the output to drain before 
setting the new parameters. This 
form should be used when 
changing parameters that will 
affect output. 

TCSETAF Wait for the output to drain, then 
flush the input queue and set the 
new parameters. 

Additional toctl(2) calls have the form: 


ioctl (fildes, command, arg) 
int arg; 
The commands using this form are: 


TCSBRK Wait for the output to drain. If 
arg is 0, then send a break (zero 
bits for 0.25 seconds). 


TCXONC Start/stop control. If arg is 0, 
suspend output; if 1, restart 
suspended output; if 2, transmit 
XOFF; if 3, transmit XON. 


TCFLSH If arg is 0, flush the input queue; if 
1, flush the output queue; if 2, 
flush both the input and output 
queues. 
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FILES ) / 
dev/tty* 
/dev/tp/* 

SEE ALSO 
stty(1), fork(2), ioctl(2), setpgrp(2), signal(2), tp(7), 
tty(7). 

WARNING 
The default value for ERASE is backspace rather than 
the historical #. 


BUGS 
Local RS-232 terminals do not currently provide hangup 
(BO), draining, flushing, or delay. 
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tiop — terminal accelerator interface 


SYNOPSIS 


#include <sys/tiop.h> 


DESCRIPTION 


The tsop driver provides loading and unloading functions 
for the terminal accelerator. The open of device 
/dev/tiop will fail if either a terminal accelerator board 
is not present, or if it is already loaded. The only 
allowable function after opening the ttop device is to 
issue an toctl to download the accelerator. The following 
command is supported via toctl: 


IOPATTACH 


Download the IOP; arg must point to 
an area in the caller’s space where the 
first 4 bytes are a count of the number 
of bytes to be loaded into the 
accelerator. The actual data must 
follow the count field immediately. 
The count bytes are copied into the 
accelerator starting at memory location 
0. After loading, the accelerator is reset 
and begins execution at O in its 
memory. After a successful 
IOPATTACH all but two onboard RS- 
232 ports will be controlled by the 
accelerator. 
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NAME 
tp — controlling terminal’s local RS-232 channels 


DESCRIPTION 

The tp devices accesses the RS-232 channels on the 
controlling terminal. The terminal must be a cluster 
terminal configured to permit use of the local RS-232 
channels (see termio(7). Just as /dev/tty permits a 
process to conveniently access its process group’s 
controlling terminal (see  tty(7)), /dev/tpa and 
/dev/tpb access the controlling terminal’s RS-232 
channels without reference to the terminal number. This 
is convenient for accessing the user’s local hardware, 
such as a telephone with an RS-232 interface. 


SEE ALSO 
tty(7). 
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NAME 
tty — controlling terminal interface 

DESCRIPTION 
The file /dev/tty is, in each process, a synonym for the 
control terminal associated with the process group of 
that process, if any. It is useful for programs or shell 
sequences that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It 
can also be used for programs that demand the name of 
a file for output, when typed output is desired and it is 
tiresome to find out what terminal is currently in use. 
If the terminal is under window management, a process 
group is controlled by a specific window and I/O on 
/dev/tty is directed to that window. A terminal can 
control one process group in each window. See 
window(7). 

FILES 
/dev/tty 
/dev/tty* 

SEE ALSO 


tp(7), window(7). 
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vme — VME bus interface 


DESCRIPTION 


Vme files are a set of special files that are images of the 
VME bus. They may be used, for example, to examine, 
and to modify memory and registers on the VME bus. 
Byte addresses in vme are interpreted as memory 
addresses. For a _ read, references to non-existent 
locations cause errors to be returned; for a write, nothing 
is written and no error is returned. 

Examining and patching device registers is likely to lead 
to unexpected results when read-only or write-only bits 
are present. 


The structure for zoctl calls is: 


#define VMGETREG = (’v’+0 
#define VMSETREG v+1 


struct vmeioctl { 
unchar vm_mreg; 
unchar mv_preg; 
unchar vm_ireg; 


The standard VME interface EEPROM contents are: 
#define VME_SLOTS 16 


struct ymeeprom { 


/* Make the entire prom checksum to -1 */ 
int checksum; 


/* EEPROM flags (diag/unix) */ 
int flags; 


/* Offset into EEPROM from the start of code */ 
ushort codeoffset; 


/* unused, reserved */ 
char unused(2}; 


struct { 
/* Board identification for this slot */ 
char type; 
/* reserved for future use */ 


char unused|7]; 
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/* Address of the board; in MightyFrame I/O space */ 


uint address; 


/* Amount of address space taken up by the board */ 


uint length; 


/* Pointer to an optional initialization function */ 
int  (*initfp)(); 


} slots|)VME_SLOTS]; 


/* Reserve the rest for controller code */ 


char drivers{7860]; 
#define VMEE_DIAG 
#define VMEE_LOADED 
#define VMET_CMC 
#define VMET_V3200 
FILES 


/dev/vme/al6 
/dev/vme/a24 
/dev/vme/a32] 
/dev/vme/a32h 


/dev/vme/eeprom 
SEE ALSO 


0 /* Diag has cleared/set EEPROM */ 
1 /* unix has loaded driver information */ 


1 /* CMC Ethernet controller */ 
2 /* Interphase SMD controller */ 


64K bytes of short address space 


32M bytes of standard address 
space 


low 2 gigabytes of extended 
address space 


high 2 gigabytes of extended 
address space 


8K VME interface EEPROM 


ldeeprom(1M), system(4), mem(7). 
MightyFrame VME Expansion Manual. 
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vt — virtual terminal 


DESCRIPTION 


A virtual terminal provides a _ terminal-like 
communication channel between two processes. Each 
virtual terminal consists of two devices: a slave device, 
whose name is of the form /dev/ttypzz, where zz is the 
virtual terminal number; and a master device, whose 
name is of the form /dev/vtzz, where zz is the virtual 
terminal number. The slave device responds to system 
calls just like a real terminal (see eermients)| #0 that it 
can control interactive programs such as vi. But instead 
of doing actual input/output, reads and writes on the 
slave device are written and read on the corresponding 
master device by another process. A typical use of a 
virtual terminal is to put a network server on the master 
device and login program on the slave. 


The number of virtual terminals must be configured. 


See config(1M). 


The process on the master device can exercise flow 
control on the slave device, much as a real terminal 
would use XON/XOFF to exercise flow control on a 
terminal device. The parameterless toctl(2) TIOCSTOP 
stops output to the slave device as if with an XOFF 
character; the parameterless toctl(2) TIOCSTART restarts 
output, as if with an XON character. 


FILES 
/dev/ttyp?? slave devices 
/dev/vt?? master devices 
SEE ALSO 
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config(1M), ttyname(3C), termio(7). 
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NAME 

window —- window management primitives 
SYNOPSIS 

#include <sys/window.h> 
DESCRIPTION 


Window managment (wm(1)) provides a superset of 
windowless terminal features. This entry describes 
terminal file features special to window management. 
Window management features are designed not to 
interfere with programs that do not know about window 
management. Such design includes simple extensions to 
the UNIX System’s standard concepts of file descriptor 
and control terminal. 


° Each terminal file descriptor has an associated 
window number, a small positive integer that 
identifies a window. A window number is the 
most primitive way to refer to a window, and 
should not be confused with the window ID used 
by window management subroutines. A new 
window gets the smallest window number not 
already in use. Closing a window frees its 
number for possible assignment to a later 
window. Output and control calls on the file 
descriptor apply only to the descriptor’s window; 
input calls succeed only when the window is 
active. 


A file descriptor created by a dup(2) or inherited 
across a fork(2) inherits the original descriptor’s 
window number. All the file descriptors in such 
a chain of inheritance, provided they belong to 
processes in the same process group, are affected 
when toctl changes the window number of any of 
them. 


° When a process group’s control terminal is under 
window managment, the process group is 
actually controlled by a particular window. 
Such can have more than one process group, 
each controlled by a _ different window. 
Keyboard-generated signals (interrupt and quit) 
go to the process group controlled by the active 
window. 


When the user creates a new window by using the SPLIT 
key, the window manager forks a process for that 
window. The new process inherits file descriptors for 
standard input (0), standard output (1), and standard 
error (2) that are associated with the new window. The 
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new process is leader of a process group controlled by the 
new window. The new process also inherits the 
environment of the parent process, which is the window 
manager itself. 


Programs that create and use windows use window 
management toctl(2) calls. Such calls take the form 


ioctl (fildes, command, arg) 
struct wioctl *arg; 


Fildes is a file descriptor for terminal and window 
affected, command is a window management command 

iste below) arg is a pointer to the following structure, 
eclared in <sys/window.h>: 


#define NWCC 2 


struct wioctl { 
wndw_t wi_dfltwndw; 
wndw_t wi_wndw; 
slot_t wi_mycpuslot; 
slot_t | wi_destcpuslot; 
port_t wi_bport; 
char wi_dummy; 
} unsigned char wi_ce[|NWCC]; 
Window management tocél calls get (WIOCGET) and set 
(WIOCSET and WIOCSETP) terminal attributes described 
in the wtoctl structure: 


wi_dfltwndw The window number for the 
process’s default window. If the 
process does an open on 
/dev/tty, the new file 
descriptor is associated with the 
default window. 


wi_wndw The window number for the 
window that fildes (tocél’s first 
parameter) is associated with. 


wi_mycpuslot (This field is required for 
istorical reasons and is not 
meaningful to the host.) 


wi_destcpuslot (This field is required for 
historical reasons; it is not 
meaningful to the host 
processor.) 


wi_bport (This field is required for 
historical reasons; it is not 
meaningful to the host 
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wi_cc 


processor.) 


(This field is required for 
historical reasons; it is not 
meaningful to the host 
processor.) Not used by the 
CTIX kernel. A value supplied 
by a WIOCSET or WIOCSETP is 
stored in a place associated with 
window wp_wndw. A 
subsequent WIOCGET on the 
same window retrieves the 
information. 


Here are the window management toctl commands: 


WIOCGET 


WIOCSET 


WIOCSETP 


WIOCLRP 


Get information on calling 
process and file descriptor 
fildes. Fill in arg. 


Set values for calling 
process and file descriptor 
fildes from information in 
arg. Has no effect on 
process group-control 
terminal relationship. 


Set values for calling 
process and file descriptor 
fildes from information in 
arg. The window specified 
in arg->wit_wndw becomes 


the process’s group’s 
controlling terminal 
provided the following: 

° The calling process 
is the process group 
leader. 

e The process group is 
not currently 
controlled by 


another window on 
this or any other 
terminal. 


° The specified 
window is not 


already a control 
window. 


Only valid executed by process 
group leader. The process group 
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ceases to have a control terminal 
or window and the control 
terminal/window ceases to control 
any process group. The process 
group is free to find another 
control terminal/window, and the 
old control terminal/window is 
free to become the control 
terminal/window for another 
process group. 


WIOCCLUSTER 


Toctl returns 1 if and only if the 
terminal is a cluster terminal. 


WIOCDIRECT Enable direct sending of terminal 


IPC requests. 


WIOCUNDIRECT 


Disable direct sending of terminal 
IPC requests. 


An open on a terminal special file other than /dev/tty 
i example, /dev/tty000) produces a file descriptor 
or the lowest-numbered open window. Joctl can move 
this file descriptor to any window. 


An open can also obtain a controlling terminal/window. 
The requirements are the same as for WIOCSETP. 


FILES 


/dev/tty — control terminal 
/dev/tty??? — terminals 


SEE ALSO 
stty(1),_ wm(1), 
termio{7), tty(7). 
WARNINGS 


dup(2), fork(2), ioctl(2), open(2), 
wmgetid(3X), wmlayout(3X), wmop(3X), wmsetid( 


, 


WIOCDIRECT and WIOCUNDIRECT are required by the 


operating system. 
inadvisable. 


Their use by user programs is 


